I installed pandoc via apt on an Ubuntu Server installation (don't recall if it's 10 or 11) without any trouble. Pandoc does have some optional Markdown extensions for dealing with inline code and syntax highlighting. Aside from seeing the syntax, I have not played around with it yet.
Unless someone else has input on the capabilities of RST to break down a single document into parts, I'll start investigating that next. Darrell Hamilton, Software Developer, 4over, Inc darre...@4over.com 818-246-1170 ext. 285 2011/8/23 Kornel Lesiński <kor...@geekhood.net> > On Tue, 23 Aug 2011 06:15:57 +0100, Darrell Hamilton <darre...@4over.com> > wrote: > > Does anyone have any additional input on this point? From what I've >> gathered, pandoc is what you want if your converting between any number of >> markup languages. It can convert to DocBook, RST, Markdown, and many >> others. Unfortunately, it does not take DocBook as an input format. >> > > pandoc is difficult to install for me. Did you get it working? > > DocBook -> HTML -> Markdown might work? > > > Based on the links provided by Christoph, there are some tools for >> converting DocBook to RST, but they appear to be in their infancy. I have >> not experimented with them yet. >> >> As a broader question, is Markdown the preferred format? Or is the format >> open to general discussion? I do not have a preference at this time nor do >> I know enough of the pros/cons of each to say anything about which is the >> better tool for the job, but it might be worth hearing from people who >> have more experience with them. >> > > I have slight preference for Markdown, since it uses single backtick for > inline code. reStructuredText is fine though. > > The next step would be to look into tool that produces multipage > documentation from the single source file. I don't know of any for Markdown, > so if reStructuredText has good (post)processors, it might be better. > Otherwise, I'll probably write something myself. > > -- > regards, Kornel Lesiński > > > ______________________________**_________________ > PHPTAL mailing list > PHPTAL@lists.motion-twin.com > http://lists.motion-twin.com/**mailman/listinfo/phptal<http://lists.motion-twin.com/mailman/listinfo/phptal> >
_______________________________________________ PHPTAL mailing list PHPTAL@lists.motion-twin.com http://lists.motion-twin.com/mailman/listinfo/phptal