Glyph is a Rapid Document Authoring Framework.
Think of it like a sort of Ruby on Rails but for creating text documents instead of web sites. With Glyph, you can manage your documents tidily in projects that can be used to generate deliverables in different formats such as HTML or PDF (through Prince).
Glyph uses a simple macro system to perform a wide variety of advanced tasks:
- Generate block-level HTML tags not commonly managed by lightweight markups, like
- Create and validate internal and external links.
- Include and validate images and figures.
- Automatically determine header levels based on the document structure.
- Automatically generate a Table of Contents based on the document structure.
- Store common snippets of text in a single YAML file and use them anywhere in your document, as many times as you need.
- Store configuration settings in a YAML file and use them anywhere in your document, as many times as you need.
- Evaluate Ruby code within your document.
- Include content only if certain conditions are satisfied.
- Define macros, snippets and configuration settings directly within your document.
- Highlight source code.
- Call macros from other macros (including snippets), avoiding mutual calls.
- Include text files in other text files.
- Include the value of any configuration setting (like author, title) in the document.
- Filter input explicitly or implicitly, based on file extensions when including files.
- Manage draft comments and todo items.
gem install glyph — simple, as always.
Essential Glyph commands
glyph init— to initialize a new Glyph project in the current (empty) directory.
glyph add introduction.textile— to create a new file called introduction.textile.
glyph compile— to compile the current document into a single HTML file.
glyph compile --auto— to keep recompiling the current document every time a file is changed.
glyph compile -f pdf— to compile the current document into HTML and then transform it into PDF using Prince.
glyph compile readme.glyph— to compile a readme.glyph located in the current directory into a single HTML file.
Glyph macros in a nutshell
Format your documents using Textile or Markdown, and use Glyph Macros to do everything else:
section[header[Something about Glyph] You can use Glyph macros in conjunction with _Textile_ or _Markdown_ to produce HTML files effortlessly. section[header[What about PDFs?|pdf] Once you have a single, well-formatted HTML file, converting it to PDF is extremely easy with a 3rd-party renderer like =>[http://www.princexml.com|Prince]. ] ]
<div class="section"> <h2 id="h_10">Something about Glyph</h2> <p>You can use Glyph macros in conjunction with <em>Textile</em> or <em>Markdown</em> to produce HTML files effortlessly.</p> <div class="section"> <h3 id="pdf">What about PDFs?</h3> <p>Once you have a single, well-formatted HTML file, converting it to PDF is extremely easy with a 3rd-party renderer like <a href="http://www.princexml.com">Prince</a>.</p> </div> </div>
- Home Page: http://www.h3rald.com/glyph/
- Repository: http://www.github.com/h3rald/glyph/
- Bug Tracking: http://www.github.com/h3rald/glyph/issues
- Development Wiki http://wiki.github.com/h3rald/glyph
- RubyGem Download http://www.rubygems.org/gems/glyph
- Book (PDF): http://github.com/h3rald/glyph/raw/0.2.0/book/output/pdf/glyph.pdf
- Reference Documentation: http://yardoc.org/docs/glyph/
- User Group: http://groups.google.com/group/glyph-framework