[TxMt] Writing a Book with TextMate
marios
tmtxpstuff at consking.com
Fri Jun 6 15:51:21 UTC 2008
Kevin Ridgway wrote:
> Hmmm, I kinda like Markdown for that kind of thing.
>
> With Markdown links to the references, etc pages in one project folder.
>
> So I guess, as a web guy, I would probably choose Markdown bundle, and
> go from there.
Ok thanks for the replies
I compiled a small list to summarize the options at hand:
1) Option Latex ( Christopher and Thomas)
Advantages:
* Can successfully handle footnoes, references and Indexes
* Provides pre-publishing Layout options
Disadvantages:
* Learning Curve
* Markup can become complex and bulk up
* How about cross platform compatability ? ( Is it possible to get
stripped down textversions and such ?)
Further Questions:
* How about Project handling ? ( My reference stuff is about 700 Mib.
Keep in seperate Project ?)
* How about Images and Charts ( I also have some charts that are done
with Omnigraffle Pro that I wanna update occasionally without loosing
reference track to the original Omnigraffle files)
2) Option Markdown ( Kevin)
Advantages:
* For Simplicity
* Easy conversion to HTML TXT and PDF
* For Layout PDF Versions Prince can be used
Disadvantages:
* Indexes , Footnotes and References can be used, however:
* Brett Terpstra's HTML Index Bundle can be used.
* If chapters are kept in single files, then this obviously makes a
conversion into other formats more complicated, need of Shell script
commands, etc.
Questions:
3) Option Scrivener in combination with Multimarkdown (Fletcher)
Advantages:
* Allows nonlinear organization and writing
* Supports multimarkdown LATEX txt and PDF Export
* Both Import and Export with footnotes and Anotations are supported,
provided, certain requirements in Document structure are met
quote:
You want flexibility in your document - you don’t want to be tied into
a single document type. With MultiMarkdown you can convert your document
to XHTML, RTF, LaTeX, or Word .doc, to name a few. With the proper
knowledge, many other formats are possible.
end quote
* A Implementation Guide is available at the Scrivener formums here:
http://www.literatureandlatte.com/forum/viewtopic.php?f=21&t=497
* Template Support and multiple Layout options
* Footnotes , Labels and refs conversion into markdown supported
further Info:
http://fletcherpenney.net/Using_MultiMarkdown_with_Scrivener
Disadvantages:
* Project maintenance might get a little out of scope
NOTE: So this basically makes it possible to maintain your Book Project
Folder under one Roof as project siblings
Also: Multimarkdown export option provides XHTML which makes parallel
Web publishing procedures and maintenance of certain Book-chapters for
promotion easier
4) Further Markdown option (Markdown2Book Bundle by John Gruber based on
initial Scripts by Allan)
http://lists.macromates.com/pipermail/textmate/2006-February/008160.html
* Designed basically for documentations:
quote:
This bundle is for compiling a Documentation project made of several
Markdown files to HTML. It generates a TOC, a print version with all
chapters on one page and HTML files for each chapter. You can use
references to easily link between your pages.
end quote
( Haven't checked this out yet in detail)
If you have any additional suggestions, Ideas and also recommendations
how a Project should be structured in each of those cases, then please
let me know. I will then update my list and publish that in short on my
Blog.
regards, marios
More information about the textmate
mailing list