From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matt Lundin Subject: Re: Documentation wishlist items Date: Wed, 16 Sep 2009 12:03:10 -0400 Message-ID: References: <9cd2f5ff0909151421r25e4c7afn8d609e76e2462193@mail.gmail.com> <87tyz3a83l.fsf@gmx.de> <871vm78bjc.fsf@bzg.ath.cx> <87r5u7f09l.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MnwyX-0001RI-8R for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 12:03:21 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MnwyS-0001PM-6a for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 12:03:20 -0400 Received: from [199.232.76.173] (port=50658 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MnwyR-0001PC-6B for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 12:03:15 -0400 Received: from out1.smtp.messagingengine.com ([66.111.4.25]:48757) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MnwyQ-00077N-Ku for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 12:03:14 -0400 In-Reply-To: <87r5u7f09l.fsf@gmx.de> (Sebastian Rose's message of "Wed, 16 Sep 2009 16:10:46 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Sebastian Rose Cc: Bastien , emacs-orgmode Sebastian Rose writes: > Bastien writes: >> Sebastian Rose writes: >> >>> Here is some kind of outline for such a tutorial. >> >> Wow. That an outline for a full book! >> >> And I guess that's what comes at the horizon: an (O-Reilly) book about >> Org-mode. It would not compete with the manual as a reference, but it >> would make it easier to more people to open Org's doors. > > > OK, let's just start it. I'd like to have the tutorial on > orgmode.org/worg. But I'm not yet sure about the structure. > > > Option (A) > is, to create an .../worg/the-org-tutorial/index.org, that just > contains an index to the chapters. Each chapter goes to a single file > in that directory. > > Option (B) > Put the entire thing into one big file. This has the advantage, that > we wouldn't need to create any extra directories on worg: > orgmode.org/worg/org-tutorials/the-org-tutorial.org > > > | | (A) Multiple files | (B) Monolitic | > |----------------------------+--------------------+---------------| > | Outlining a skeleton | - | + | > | Restructure | - | + | > | Multiple editors | + | - | > | Distribution (e.g. as PDF) | - | + | > | Easy navigation | + | - | > |----------------------------+--------------------+---------------| > | Sum | -1 | +1 | > > > > Thoughts? My vote would be for separate files that could also be published as a monolithic pdf file. I know the possibility of publishing multiple files as a single book exists in muse, but how would one do that with org-mode? Is there a directive to publish separate html files and a monolithic pdf file simultaneously (perhaps via #+INCLUDE directives)? - Matt