Commit Graph

6 Commits

Author SHA1 Message Date
Mark Harrah 0ff96da70e Docs: clean up Getting-Started/Basic-Def, including an example of defining a key. Fixes #862. 2013-09-18 10:27:19 -04:00
Mark Harrah d0a8f40b99 Docs: last updates to getting started guide for 0.13.0 2013-08-23 01:58:07 -04:00
Mark Harrah c14179c358 Docs: custom role 'codeliteral' to allow substitutions in inline code
The built-in 'literal' role implements ``.  It tokenizes the
literal string to attempt some particular wrapping behavior.
This puts parts of the string in different spans, each with
class='pre' and the previous docs.css had a padding for that
class.  This led to excessive space within the literal string.

The custom role does no do this tokenization, but nested
inline parsing can result in multiple nodes, repeating the
problem.  So, the padding for class='pre' is dropped.  Ideally,
the sequence of nodes would simply be wrapped in an inline element
with class='pre' or some other proper solution that avoids having
multiple nodes.

To avoid wrapping in the middle of a literal, the 'pre' class
now has the style `white-space: pre;`.

The default role is now 'codeliteral' and the previous
uses of the built-in `` are converted to `.  Some incorrectly
converted code blocks were fixed in the process.

Finally, the Global-Settings page is updated with the new location
for the global sbt directory.  Due to the above changes, this could
be done without hardcoding the version.
2013-07-29 07:27:17 -04:00
Mark Harrah 518bbc4077 Docs: more cleanup for 0.13 2012-12-06 19:11:07 -05:00
Mark Harrah 132e29415b Docs: initial pass for updated task syntax, vals in .sbt, camelCase 2012-11-19 22:14:12 -05:00
Mark Harrah b98e12e9dd first step in md -> rst conversion 2012-09-30 20:36:38 -04:00