Building An Authoring Environment For The Web, Part 1

What I want is a web/cloud based authoring environment that gives me the capability to create documents that can are digital and can be displayed as needed. Some examples include a blog post, an essay, a research article, a presentation, documentation, notes, and so on.

First up is a flexible text markup system. I need something that is capable of handling a lot of different markup elements. Some of the documents that I need to create have complex structures that are not easily simplified. After looking at a number of markup schemes including various wiki languages and Markdown, I decided to go with AsciiDoc. AsciiDoc provides text markup for most elements of DocBook 4.5 allowing for the creation of highly structured documents using a simple text editor.

At this writing there are 2 tool chains for rendering AsciiDoc. The original AsciiDoc, which is written in Python and AsciiDoctor, a new native Ruby version. I plan on using AsciiDoctor for most of the work, but will need to fall back to the original tool chain for some features (like PDF generation). I will be installing both.

Next up, solving the web-based editor issue.

Managing The Transition From Print Books to Digital Resources

Introductory Note»

 

Overtime the CALI eLangdell Project has morphed and evolved starting starting as a radical attempt to revolutionize course materials in legal education and leading to the founding of a more traditional ebook imprint that today provides free, CC licensed casebooks and supplementary materials to legal education. One constant has remained over this transition: how to manage the transition from print to digital formats. This transition, required of both authors and readers, is a difficult one and more complex in the education space than in the leisure reading space. I will tell you now that I don’t have  definitive answer to this problem, but I have some ideas.

Much of the focus with eLangdell is on the authoring of material and that will be my focus for the balance of this piece. The creation of digital legal education materials, like any another form of creation, is hard work. Making it more difficult are the habits and assumptions of our author pool. Like textbook authors everywhere, authors of legal casebooks come to the table with a career full of assumptions about being an author. They are writing for print. They expect long lead times with only occasional updates. They want a physical artifact, a book, that memorializes their effort. None of this really applies in the digital world. The material may never be printed. It needs to produced with a sense of immediacy and the ability to quickly and frequently update. There will not be a physical artifact to put on a shelf.

To successfully manage the transition from print books to digital resources these three points need to be dealt with to change the way authors create. And it isn’t going to be easy.

Producing real digital resources, forgetting about print

Authors, and most everyone else, still write for print. The tools we use are often intended to produce beautiful printed pages. Printed on paper. With all the limitations and structure that comes with the printed page. Word processors are designed to first mimic typewriters. Typewriters strike an image of type to a paper page. When an author sits down and opens Microsoft Word all the metaphors of the print world are brought to bear. And this isn’t necessarily a bad thing if that’s what you want to do.

Creating digital resources requires a different approach. A key feature of the digital realm is the ability to separate content and presentation. Separate the words from the page. Producing content for this environment is fundamentally different than producing content for print where content and presentation are typically tightly linked. Word processors conflate content and presentation in such a way that the two are difficult to separate. This leads to great difficulty in moving word processor documents into the truly digital realm.

The solution is to scrap word processors as we know them today and use a more basic text editor with a limited amount of readable markup to create the digital resources that will replace print books. Text markup languages such as AsciiDoctor and  Markdown and more sophisticated XML schemes like HTML and DocBook provide the sort of markup that allows the author to create reusable content that still conveys information about what the author intends to emphasize. That is to say, you can still use bold and italics and notes to get your point across.

Once word processors are scrapped the exact tool and even the markup language used become less important than the actual content produced. There are many very capable text editors, some, like the one I’m using now, are on the web and run in your browser from anywhere. Others are desktop programs that run locally like your old word processor. All produce marked up text that is not just content but data that be reused and reformatted.

By making the switch from writing for print to writing for digital, the author brings the focus back to the content being created. And that should be of primary importance, especially to legal educators.

Digital content is live, now and forever

Writing for print brings with it the long lead times and occasional updates of the printed book. Writing for digital is more immediate, and allows for frequent updates and revisions. Creating a digital resource means releasing a work that will be forever live on the network. That may sound a little scary, but it isn’t meant to be. Authors creating digital content just need to be aware that once the content is released it will be out there, somewhere, for a very long time.

The best tools for creating digital resource allow for the frequent updating and revising of the work. This is one of the great things about writing digital. In the legal education realm this means being able to revise your materials to include the latest changes in the law as the changes occur. No more waiting 2 years for a pocket part that includes changes that are already a year old. Updating and revising become a more regular part of the authoring process.

Writing digital provides for easier collaboration, making those updates and a revisions a kind of community exercise. Gone are the days of sending word processor files around and the endless effort to make sure that work is incorporated properly. Again we can use readily available tools to manage digital resource creation in such a way that multiple authors can work in harmony without spending valuable time tripping over each other.

Not a physical artifact, but a web site

Writing for print implies that you are writing for the grandest of print prizes, a book. A book is a physical artifact that contains the printed writing of the author. The things that the author does in the word processor are with an eye toward what is going to come out on a printed page, and ultimately a book. Writing for digital is a whole other animal. Since creating digital resources is more about content than presentation that means that writing digital can result in a web site, a wiki, a blog, a podcast, series of tweets, a slide show, a PDF, even a physical book. It really doesn’t matter about the final container of the content so long as the content is free to be loaded into the container. And creating that content is what writing digital is all about.

The movement away from the print book as the final end game of authorship is something that will take a lot of getting used to, but it is going to happen. And it will liberate authors from constraints they didn’t even realize they had. In legal education it means creating learning resources that are interactive, collaborative, and current in a format that allows for the free flow of the content in the format appropriate for the teacher and student.

Like this post the road from print to digital is long, unclear, and confusing, but it is a road we need to travel.

 

I talk to a lot of people and read a lot of material about ideas and concepts surrounding ebooks especially as related to the CALI eLangdell project. Some of the things discussed below will undoubtedly sound familiar to John Mayer, Deb Quentel, Sarah Glassmeyer, and others. I just want to acknowledge upfront that some of their ideas are included below.Powered by Hackadelic Sliding Notes 1.6.5

Media Commons white paper examines future of transparency in peer review

The always-insightful Alex Reid has penned an essay “on the question of open peer review,” which examines a draft white paper posted to Media Commons last week. The paper—Open Review: A Study of Contexts and Practices—struggles, Reid argues, to address a critical question: “What is the problem with existing scholarly review procedures that the open review process seeks to solve?”

via New Media Commons white paper examines future of transparency in peer review | opensource.com.

 

Swaapr Brings Peer-to-Peer Textbook Rentals to College Campuses

Our company mission is simple: We want to make your college experience more affordable and fun. We believe in transparency, integrity, and customer satisfaction at the highest level. This company was founded by the three college students who were tired of getting ripped off by companies that capitalize on college students. So we built a service with the college student in mind. We offer peer to peer rentals as well as allow students who wish to share skills that with one another on one’s college campus.

via Swaapr | About Us.

Seems like a pretty good idea. It seems like Swaapr just got off the ground a month or so ago, so it will be interesting to keep an eye on them as they grow. You can follow along on the the Swaapr blog or Twitter.

What Is Publishing? A Report from THATCamp Publishing – ProfHacker – The Chronicle of Higher Education

Go To Hellman: Creative Commons Media Neutrality and eBook Rights after Rosetta v. Random

Are Open Access and Traditional Publishers in the Same Business?

FastPencil Brings Self-publishing To The Web

FastPencil is self-publishing with a twist. The traditional publishing process is a daunting one that can take many months of effort and more money than most writers anticipate. It’s no wonder authors get discouraged.

You shouldn’t have to ask anyone’s permission to write and publish your own book! We have removed the hurdles inherent in traditional publishing by combining amazing advances in print on demand technology with a sophisticated online workflow system.

FastPencil

This site provides a one stop resource for writing and publishing a ‘book’. On the authoring side it provides a light weight web interface for creating an outline and entering text so you can write in the browser. It provides tools for importing blog posts, adding collaborators, assigning editors and more.

Once you’ve committed your work to ‘paper’ the publishing features allow you to categorize the work, set copyright, including Creative Commons licensing, add cover art, and select formats. You may publish your work as an EPUB e-book or as a printed book. If you opt for a physical artifact, you can select typeface, paper size, set a price, and more.

FastPencil is free to use up to the point where you want to order physical books. Packages are available that provide services such as professional review and editing, cover art design, retail distribution and more.

So, it looks like FastPencil may be a good choice for authors interested in retaining complete control over their work or those interested in publishing their work but not inclined to clear all of the hurdles imposed by traditional publishers.