Comments on: Writing a book collaboratively? http://www.markshuttleworth.com/archives/59 Planetary perspectives Fri, 12 Dec 2014 10:34:08 +0000 hourly 1 http://wordpress.org/?v=3.9.3 By: Tools for collaborative authoring and editing: wikis vs. Wordpress vs. SharePoint http://www.markshuttleworth.com/archives/59/comment-page-2#comment-353542 Thu, 19 May 2011 11:29:27 +0000 http://www.markshuttleworth.com/archives/59#comment-353542 [...] Mark Shuttleworth blog archives: Writing a book collaboratively? [...]

]]>
By: Un libro su Ubuntu Edgy Eft, scritto in collaborazione! http://www.markshuttleworth.com/archives/59/comment-page-2#comment-313182 Sat, 22 Nov 2008 17:44:50 +0000 http://www.markshuttleworth.com/archives/59#comment-313182 [...] Mark Shuttleworth anticipa la mia ricerca in questo suo post, e devo dire che tra i commenti relativi sono venute fuori diverse idee. La questione è: voglio [...]

]]>
By: Lucas http://www.markshuttleworth.com/archives/59/comment-page-2#comment-276362 Mon, 17 Mar 2008 20:47:00 +0000 http://www.markshuttleworth.com/archives/59#comment-276362 Debian uses moinmoin to convert moinmoin pages to docbook to pdf/html/ other…
check it out:

http://wiki.debian.org/DebianReference

]]>
By: 暴走外人CEO奮闘日記 » Blog Archive » Wikiで本・書籍・マニュアルを書く方法 http://www.markshuttleworth.com/archives/59/comment-page-2#comment-182916 Sat, 20 Oct 2007 00:45:43 +0000 http://www.markshuttleworth.com/archives/59#comment-182916 [...]  まず調べたら、海外ではこのブログ（http://www.markshuttleworth.com/archives/59）で過去に議論がある。というか、ブログに書き込んだだけで８０人ぐらいコメントあるっていうのはすげーな！こいつなにもの？ [...]

]]>
By: Marbux http://www.markshuttleworth.com/archives/59/comment-page-2#comment-149158 Sun, 19 Aug 2007 21:26:23 +0000 http://www.markshuttleworth.com/archives/59#comment-149158 Is there a particular reason for selecting Docbook as the output format? I would suspect that OpenDocument ODT format would be preferred, since Edubuntu ships with OpenOffice.org.

I recommend that you seriously investigate two apps designed for the purpose of creating books. One is SiSU, http://www.jus.uio.no/sisu/ (;) the other has already been mentioned, the Daisy platform. http://cocoondev.org/daisy/index.html (.)

SiSU outputs, among many formats, ODT, LaTeX, PDF, HTML, and structured XML. It is a mature publishing framework for creating lengthy articles and books, using a wiki-like markup in plain ASCII files as input, with the same imput file outputting to multiple formats. Features for academic writing are particularly strong, given SiSU’s origin as a publishing tool for legal texts. However, I’m unsure of its support for mathematical symbols, having never used them in SiSU, so it might be necessary to add them in LaTeX. The SiSU markup is far more mnemonic than most wiki syntaxes, and for me was easier to learn. (I prefer writing in XHTML markup myself.)

SiSU has outstanding support for numbering of all supported object types, e.g., chapter, page, paragraph, line, footnotes. The SiSU site has numerous sample books. It will also automagically generate a concordance for indexing purposes.

Downsides: No WYSIWYG editor, lacks strong management features for documents, versions, and variants. Has Linux/Unix dependencies.

I won’t add much to what’s already been said about Daisy. Daisy does have a WYSIWYG editor and very strong management features for documents, versions, and variants. It also has strong transclusion capabilities, providing a single editing point for recurring content, which IMHO is a critical feature when producing documents with overlapping content.

Supports ODT and several other formats out of the box, but apparently not Docbook. But with the underlying Cocoon componentry framework, adding additional output formats should be fairly trivial. See generally http://cocoon.apache.org/2.1/features.html (.) And with Cocoon as the framework, it should also be feasible in Daisy to use a WebDAV client such as OOo as the “live” input editor.

Creating cross-referencing links in Daisy is particularly easy, with a search dialog built into the link forming system.

Between the two systems, I left SiSU for Daisy because of users’ strong preference for working with a WYSIWYG editor, Daisy’s far stronger document management system, and stronger collaboration features. But that came at the cost of the far more robust document formatting capabilities in SiSU.

]]>
By: The Net Duck http://www.markshuttleworth.com/archives/59/comment-page-2#comment-72838 Tue, 10 Apr 2007 22:05:20 +0000 http://www.markshuttleworth.com/archives/59#comment-72838 hi,
I was interested in the post because a while back I had tried to start a little website that people could write books together and got some activity, but wasn’t able to keep it running. I think it’s a great Idea especially for education. The site was bookmaster.proboards7.com and was fun.
So not to seem like I am trying to spam, I think that the best platform would be python because it is like java (just better) because it’s multi platform based.I guess that kind of seems obvious.

The Net Duck

]]>
By: Holger Rauch http://www.markshuttleworth.com/archives/59/comment-page-2#comment-34056 Mon, 22 Jan 2007 12:07:58 +0000 http://www.markshuttleworth.com/archives/59#comment-34056 Does anybody know of a Wiki supporting the syntax used by Asciidoc (http://www.methods.co.nz/asciidoc/)? If a Wiki does not support the Asciidoc syntax directly, is there some way to make it “understand” (parse and render) Asciidoc markup?

Thanks in advance for any hints/pointers!

Kind regards,

Holger

]]>
By: Riccardo Murri http://www.markshuttleworth.com/archives/59/comment-page-2#comment-31385 Tue, 16 Jan 2007 14:31:59 +0000 http://www.markshuttleworth.com/archives/59#comment-31385 I think that the main issue in writing a book collaboratively through
a Wiki is how to build an open and active community of contributors.
Building a community of contributors entails lowering the threshold to
editing, so that people aren’t scared off by technical and
typographical details, and can focus on the *content* they add.
Failing to build that, there’s no advantage over the usual editor+CVS
model of collaborative writing.

I was able to find very little on the net about this human-interface
side of “writing a book collaboratively”, and very little support from
current software. (I’d be pleased to hear about any thought on the
topic.) It might be that this is a very new topic, and solutions are
only beginning to be drafted.

I have been setting up a Wiki for collaborative writing and editing of
a tutorial book on Grid Computing ( http://www.egrid.it/doc/gme ); we
use it as an online reference resource, and print copies to hand out
to participants at training events. We also would like participants
at training events to edit the content to clarify points that were
written in initiated jargon, share their view, add their own examples
and experiences — in short, have the text reflect a community
experience.

Here comes the problem. Just putting the text into a Wiki isn’t
sufficient:

1- Every contributor has to learn the markup language used by the
Wiki system.[1]

2- More important, every contributor has to agree to some stylistic
and typographical conventions (how to format computer output and
examples, usage of acronyms, etc.), or you end up with
inconsistently-formatted text.

It is *very important* to keep the effort needed as light as possible,
or you loose contributors, that is, active community members. (In our
case, it’s scientific researchers that perceive the time spent in
learning the details of some computer program as time wasted in not
doing useful research — even if it could save them some later on…)

I believe that item 2 above is the most important one: coherent
typographical rendering is *very* important to novice readers, who
often cannot tell apart the different elements from context alone.[2]
Coherent typographical conventions convey “action” clues (e.g.,
monospaced text is for “type on keyboard exactly as written in text”)
but they *need to stay the same throughout the text*.

In the end, here’s a few technical details on how we are trying to do
it:

– We use reStructuredText for Wiki markup; most reST markup is just
formatting a plain text document for better reading. It helps to
keep the page sources readable even after many edits, and could
reduce the learning time and effort required by prospective
contributors.

– We require authors to comply with some (hopefully simple and
natural) text formatting conventions. Of course, the conventions
are stated on a Wiki page, so they can be discussed and changed -
establishing the conventions is part of book writing itself!

– From time to time, we dump the page *sources*, assemble them, and
produce a PDF booklet (reST -> LaTeX -> PDF), that we can print
and hand out.

.. footnotes:

.. [1] WYSIWYG editors might lighten the effort required here,
although I think that most WYSIWYG editors are harder to use than
well-designed lightweight text markup, for anything other than
casual editing of short text.

.. [2] Think of GNU/Linux novices learning bash command-line usage:
if the book lists an example line reading “bash$ grep ‘myregex’
myfile.txt”, will they know that they should not type the “bash$”
part if it’s not written in a different font or color? will all of
them understand that they should substitute their own values for
“myregex” and “myfile.txt” without any visual clue?

]]>
By: Rudd-O http://www.markshuttleworth.com/archives/59/comment-page-2#comment-15471 Thu, 23 Nov 2006 09:39:10 +0000 http://www.markshuttleworth.com/archives/59#comment-15471 Mark,

I wrote a book using MediaWiki, for my thesis. I developed software that consolidates MediaWiki pages into a single HTML (Boom! book microformat) page with the images inlined in the book. I found it a breeze to work with MediaWiki and then consolidate the book at any time when anyone wanted a “snapshot” of the work in progress, and it was also easy to generate the final printed output.

http://software-libre.rudd-o.com is the address. MediaBook is the software. Feel free to contact me or have anyone in your staff contact me if you want help on how to use it.

]]>
By: Ev http://www.markshuttleworth.com/archives/59/comment-page-2#comment-13809 Wed, 15 Nov 2006 18:13:56 +0000 http://www.markshuttleworth.com/archives/59#comment-13809 How did you finally resolve the problem Mark?

]]>
http://www.markshuttleworth.com/archives/59/feed
www.markshuttleworth.com
crawl=CC-MAIN-2014-52
24872
application/http; msgtype=response
sha1:GXNCDV53QKRADOF452PEIYRU56SLHGMD
<urn:uuid:7b8cafdd-376e-430f-afd0-b8fc693708ad>
2014-12-19T20:11:38Z
91.189.89.122
sha1:46OQO3CI73IZV7KMVAOZREEL7K4NAXSG
<urn:uuid:28686190-f36a-44c7-9cad-eb88dd574305>
http://www.markshuttleworth.com/archives/59/feed
response
<urn:uuid:64c86acd-df2a-4b1e-a0c0-49e065bcc1f4>
robots: classic
hostname: ip-10-231-17-201.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2014-52
operator: CommonCrawl Admin
description: Wide crawl of the web with URLs provided by Blekko for December 2014
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf