glyph 0.3.0 → 0.4.0

data/book/document.glyph

@@ -6,94 +6,318 @@ book[
 		?[eq[$[filters.highlighter]|ultraviolet]|style[ultraviolet/lazy.css]]
 	]
 	@pre-title[
-		?[eq[$[document.output]|pdf]|image[@width[20%]@height[20%]glyph.svg]]
-		?[eq[$[document.output]|html]|image[@width[20%]@height[20%]glyph.png]]
+		?[
+			and[
+				eq[$[document.output]|pdf]|
+				eq[$[output.pdf.generator]|prince]
+			]|image[@width[20%]@height[20%]glyph/glyph.svg]]
+		?[
+			or[
+				eq[$[document.output]|html]|
+				and[
+					eq[$[document.output]|pdf]|
+					eq[$[output.pdf.generator]|wkhtmltopdf]]
+			]|image[glyph/glyph.png]]
 	]
 	@frontmatter[
 		toc[3]
 		introduction[
 			@title[Introduction]
-			textile[include[introduction]]
+			@src[introduction]
 			section[
 				@title[License]
-				textile[include[license]]
+				@src[license]
 			]
 		]
 		acknowledgement[
-			@title[Acknowledgement]
-			textile[include[acknowledgement]]
+			@title[Acknowledgements]
+			@src[acknowledgements]
 		]
 	]
 	@bodymatter[
 		chapter[
 			@title[Getting Started]
-			include[getting_started/create_project]
-			include[getting_started/structure]
-			include[getting_started/configuration]
+			section[
+				@title[Creating your first Glyph Project]
+				@src[getting_started/create_project]
+			]
+			section[
+				@title[Document Structure]
+				@id[struct]
+				@src[getting_started/structure]
+			]
+			section[
+				@title[Project Configuration]
+				@id[cfg]
+				@src[getting_started/configuration]
+			]
 		]
 		chapter[
 			@title[Authoring Documents]
-			include[text_editing/glyph_files]
-			include[text_editing/macro_intro]
-			include[text_editing/sections]
-			include[text_editing/links]
-			include[text_editing/images]
-			include[text_editing/code]
-			include[text_editing/raw_html]
-			include[text_editing/stylesheets]
-			include[text_editing/inclusions]
-			include[text_editing/evaluation]
-			include[text_editing/conditionals]
+			section[
+				@title[.glyph files]
+				@src[text_editing/glyph_files]
+			]
+			section[
+				@title[Introducing &[macros]]
+				@id[macro_intro]
+				@src[text_editing/macro_intro]
+			]
+			section[
+				@title[Macro attributes]
+				@id[attribute_intro]
+				@src[text_editing/attribute_intro]
+			]
+			section[
+				@title[Escaping and Quoting]
+				@id[esc_quot]
+				@src[text_editing/esc_quot]
+			]
+			section[
+				@title[Sections and Headers]
+				@id[sec_head]
+				@src[text_editing/sections]
+				section[
+					@title[Section Aliases]
+					@src[text_editing/section_aliases]
+				]
+				section[
+					@title[Topics]
+					@id[topics]
+					@src[text_editing/topics]
+				]
+			]
+			section[
+				@title[Links and Bookmarks]
+				@id[links]
+				@src[text_editing/links]
+			]
+			section[
+				@title[Images and Figures]
+				@id[img_fig]
+				@src[text_editing/images]
+			]
+			section[
+				@title[Source Code]
+				@id[source_code]
+				@src[text_editing/code]
+			]
+			section[
+				@title[Other HTML Elements]
+				@id[other_elements]
+				section[
+					@title[&[markups]]
+					@src[text_editing/raw_html]
+				]
+				section[
+					@title[XML Fallback]
+					@src[text_editing/xml_fallback]
+				]
+			]
+			section[
+				@title[Adding Stylesheets]
+				@id[stylesheets]
+				@src[text_editing/stylesheets]
+			]
+			section[
+				@title[Including Files and Snippets]
+				@id[incl]
+				@src[text_editing/inclusions]
+			]
+			section[
+				@title[Evaluating Ruby code and Configuration Settings]
+				@src[text_editing/evaluation]
+			]
+			section[
+				@title[Conditional Macros]
+				@id[cond_macros]
+				@src[text_editing/conditionals]
+			]
 		]
 		chapter[
 			@title[Generating Output Files]
-			include[compiling/compiling]
-			include[compiling/lite_mode]
-			include[compiling/programmatic_usage]
+			section[
+				@title[Compiling a project]
+				@id[compile]
+				@src[compiling/compiling]
+			]
+			section[
+				@title[Compiling single Glyph files]
+				@id[lite_mode]
+				@src[compiling/lite_mode]
+			]
+			section[
+				@title[Using Glyph programmatically]
+				@src[compiling/programmatic_usage]
+			]
+		]
+		chapter[
+			@title[Document Statistics]
+			@id[stats]
+			section[
+				@title[Using the stats command]
+				@src[stats/stats]
+			]
+			section[
+				@title[Macro Statistics]
+				@src[stats/macros]
+				@id[stats_macros]
+			]
+			section[
+				@title[Snippet Statistics]
+				@src[stats/snippets]
+				@id[stats_snippets]
+			]
+			section[
+				@title[Bookmark Statistics]
+				@src[stats/bookmarks]
+				@id[stats_bookmarks]
+			]
+			section[
+				@title[Link Statistics]
+				@src[stats/links]
+				@id[stats_links]
+			]
 		]
 		chapter[
 			@title[Extending Glyph]
 			@id[extending]
-			include[extending/internals]
-			include[extending/macro_def]
-			include[extending/params_attrs]
-			include[extending/bookmarks_headers]
-			include[extending/placeholders]
-			include[extending/validators]
-			include[extending/interpreting]
-			include[extending/further_reading]
+			section[
+				@title[A quick look at Glyph's internals]
+				@src[extending/internals]
+			]
+			section[
+				@title[Defining Custom Macros]
+				@id[macro_def]
+				@src[extending/macro_def]
+				section[
+					@title[Parameters and Attributes]
+					@src[extending/params_attrs]
+				]
+				section[
+					@title[Bookmarks and Headers]
+					@src[extending/bookmarks_headers]
+				]
+				section[
+					@title[Using Placeholders]
+					@src[extending/placeholders]
+				]
+				section[
+					@title[Using Validators]
+					@src[extending/validators]
+				]
+				section[
+					@title[Interpreting Glyph Code]
+					@id[interpreting]
+					@src[extending/interpreting]
+				]
+				section[
+					@title[Layouts]
+					@id[layouts]
+					@src[extending/layouts]
+				]
+				section[
+					@title[Further Reading]
+					@src[extending/further_reading]
+				]
+			]
+			section[
+				@title[Defining Custom Commands and Tasks]
+				@src[extending/commands_tasks]
+				section[
+					@title[Defining Custom Tasks]
+					@src[extending/task]
+					@id[custom_task]
+					section[
+						@title[Custom Output Formats]
+						@src[extending/output_format]
+					]
+				]
+				section[
+					@title[Defining Custom Commands]
+					@src[extending/command]
+					@id[custom_command]
+				]
+			]
 		]
 		chapter[
 			@title[Troubleshooting]
-			include[troubleshooting/errors_intro]
-			include[troubleshooting/errors_generic]
-			include[troubleshooting/errors_parser]
-			include[troubleshooting/errors_command]
-			include[troubleshooting/errors_macro]
+			section[
+				@title[Generic Errors]
+				@src[troubleshooting/errors_generic]
+			]
+			section[
+				@title[Parsing Errors]
+				@src[troubleshooting/errors_parser]
+			]
+			section[
+				@title[Command Errors]
+				@src[troubleshooting/errors_command]
+			]
+			section[
+				@title[Macro Errors]
+				@src[troubleshooting/errors_macro]
+			]
 		]
 	]
 	@backmatter[
 		appendix[
 			@title[Command Reference]
 			@id[cmd_ref]
-			include[ref_commands]
+			@src[ref_commands]
 		]
 		appendix[
 			@title[Macro Reference]
 			@id[macro_ref]
-			include[macros/macros_core]
-			include[macros/macros_block]
-			include[macros/macros_inline]
-			include[macros/macros_filters]
-			include[macros/macros_structure]
+			section[
+				@title[Core Macros]
+				@src[macros/macros_core]
+			]
+			section[
+				@title[Block Macros]
+				@src[macros/macros_block]
+			]
+			section[
+				@title[Inline Macros]
+				@src[macros/macros_inline]
+			]
+			section[
+				@title[Filter Macros]
+				@id[f_macros]
+				@src[macros/macros_filters]
+			]
+			section[
+				@title[Structure Macros]
+				@src[macros/macros_structure]
+			]
 		]
 		appendix[
 			@title[Configuration Reference]
 			@id[cfg_ref]
-			include[ref_config]
+			section[
+				@title[document.*]
+				@id[cfg_document]
+				@src[config/document]
+			]
+			section[
+				@title[filters.*]
+				@id[cfg_filters]
+				@src[config/filters]
+			]
+			section[
+				@title[options.*]
+				@id[cfg_options]
+				@src[config/options]
+			]
+			section[
+				@title[output.*]
+				@id[cfg_output]
+				@src[config/output]
+			]
 		]
-		appendix[@title[Changelog]
-		include[changelog]
+		appendix[
+			@title[Changelog]
+			@src[changelog]
 		]
 	]
 ]

data/book/images/glyph/glyph.eps

@@ -0,0 +1,123 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%CreationDate: Fri Aug 20 11:57:26 2010
+%%LanguageLevel: 3
+%%BoundingBox: 0 0 314 356
+%%EndComments
+newpath
+0.00 356.00 moveto
+123.01 356.00 lineto
+118.52 355.98 118.62 349.97 120.00 346.98 curveto
+123.43 341.74 129.02 338.52 134.06 335.04 curveto
+142.35 329.07 150.25 322.60 158.15 316.13 curveto
+162.33 312.60 168.02 310.47 173.49 311.70 curveto
+176.68 312.56 178.25 315.98 178.67 319.01 curveto
+179.43 325.01 177.57 330.95 175.57 336.54 curveto
+173.01 343.63 165.76 347.43 159.18 350.09 curveto
+149.67 352.87 139.87 354.51 130.09 356.00 curveto
+314.00 356.00 lineto
+314.00 0.00 lineto
+0.00 0.00 lineto
+0.00 356.00 lineto
+closepath
+1.000 1.000 1.000 setrgbcolor
+fill
+newpath
+123.01 356.00 moveto
+130.09 356.00 lineto
+139.87 354.51 149.67 352.87 159.18 350.09 curveto
+165.76 347.43 173.01 343.63 175.57 336.54 curveto
+177.57 330.95 179.43 325.01 178.67 319.01 curveto
+178.25 315.98 176.68 312.56 173.49 311.70 curveto
+168.02 310.47 162.33 312.60 158.15 316.13 curveto
+150.25 322.60 142.35 329.07 134.06 335.04 curveto
+129.02 338.52 123.43 341.74 120.00 346.98 curveto
+118.62 349.97 118.52 355.98 123.01 356.00 curveto
+closepath
+0.000 0.000 0.000 setrgbcolor
+fill
+newpath
+186.01 295.88 moveto
+208.72 298.99 231.38 302.44 254.09 305.51 curveto
+259.18 306.10 264.32 304.38 268.43 301.41 curveto
+276.14 295.88 283.83 290.29 291.13 284.21 curveto
+293.95 281.76 297.00 279.37 298.74 275.98 curveto
+295.36 271.26 289.34 269.82 284.22 267.75 curveto
+270.01 263.29 257.09 255.56 245.06 246.92 curveto
+242.37 245.18 239.54 242.97 236.17 243.15 curveto
+233.79 243.57 233.43 246.55 234.33 248.40 curveto
+237.75 256.63 241.37 264.78 245.06 272.90 curveto
+246.33 276.04 247.84 279.40 247.26 282.85 curveto
+245.80 285.38 243.50 287.79 240.77 288.83 curveto
+230.74 289.51 220.72 288.03 210.75 287.04 curveto
+170.26 282.13 129.46 277.97 89.97 267.31 curveto
+82.35 265.62 74.93 261.94 66.95 262.86 curveto
+63.31 263.17 59.95 264.65 56.61 266.04 curveto
+53.57 258.57 50.45 251.13 47.47 243.64 curveto
+43.26 233.09 38.75 222.42 31.56 213.51 curveto
+29.38 210.97 25.62 207.84 22.21 210.12 curveto
+18.16 213.48 17.08 219.05 15.74 223.88 curveto
+14.18 230.95 12.22 239.48 17.41 245.56 curveto
+24.69 253.73 31.83 262.05 38.15 270.99 curveto
+41.18 275.04 42.83 279.99 43.05 285.03 curveto
+43.37 288.72 42.34 292.96 44.83 296.12 curveto
+46.36 297.87 48.82 296.55 50.27 295.39 curveto
+55.41 291.38 58.98 285.34 60.35 279.00 curveto
+102.38 283.59 143.97 291.40 186.01 295.88 curveto
+closepath
+0.000 0.000 0.000 setrgbcolor
+fill
+newpath
+171.35 247.88 moveto
+177.72 250.47 185.25 252.08 191.63 248.58 curveto
+198.97 244.46 206.20 240.03 212.79 234.76 curveto
+215.76 232.24 219.18 229.25 219.19 225.01 curveto
+219.29 221.43 215.86 219.21 212.81 218.31 curveto
+202.61 215.22 193.91 208.80 185.69 202.24 curveto
+175.20 194.59 164.82 186.78 154.74 178.60 curveto
+161.24 171.38 166.08 162.69 168.41 153.23 curveto
+182.72 155.01 197.08 156.48 211.44 157.81 curveto
+230.07 160.45 248.64 163.50 267.13 167.01 curveto
+272.02 168.28 277.46 169.72 282.27 167.36 curveto
+292.13 162.80 301.54 156.98 309.31 149.32 curveto
+312.18 146.75 312.67 140.98 308.85 139.09 curveto
+304.88 137.32 300.43 138.35 296.28 138.69 curveto
+277.94 140.56 259.51 141.63 241.09 142.21 curveto
+217.91 140.81 194.69 139.71 171.59 137.24 curveto
+172.68 129.83 173.23 122.36 173.57 114.88 curveto
+176.00 87.76 176.91 59.90 169.79 33.37 curveto
+167.91 25.86 165.71 18.24 161.41 11.71 curveto
+158.83 7.84 154.89 4.30 150.04 4.01 curveto
+146.06 3.83 142.67 6.33 139.97 8.97 curveto
+126.97 21.54 112.47 32.43 97.55 42.61 curveto
+93.42 45.47 88.94 47.96 85.55 51.74 curveto
+87.21 53.39 89.63 53.98 91.90 53.48 curveto
+104.66 51.13 117.35 48.44 130.07 45.93 curveto
+135.08 45.46 141.93 44.99 144.82 50.07 curveto
+149.04 57.73 149.63 66.69 150.94 75.17 curveto
+154.16 95.20 152.67 115.59 150.43 135.63 curveto
+126.34 133.69 102.29 130.67 78.62 125.72 curveto
+64.75 122.55 50.62 120.67 36.74 117.53 curveto
+32.74 116.28 28.37 114.02 24.20 116.07 curveto
+16.24 119.54 7.59 123.02 2.13 130.11 curveto
+-0.48 133.02 0.13 139.29 4.93 139.09 curveto
+24.33 139.43 43.77 139.99 63.06 142.25 curveto
+83.15 144.88 103.33 146.74 123.48 148.84 curveto
+131.41 149.52 139.31 150.68 147.28 151.02 curveto
+144.96 160.27 142.15 169.42 138.22 178.12 curveto
+137.13 180.69 135.77 183.23 135.43 186.04 curveto
+135.31 188.33 137.84 190.29 140.02 189.45 curveto
+143.94 188.11 147.38 185.66 150.45 182.92 curveto
+159.12 195.79 167.92 208.58 176.96 221.19 curveto
+178.66 223.40 179.18 226.97 176.99 229.04 curveto
+173.79 232.14 168.73 232.58 164.67 231.10 curveto
+147.52 224.93 130.41 218.67 113.17 212.75 curveto
+108.93 210.84 104.62 208.77 99.88 208.63 curveto
+91.62 208.01 83.78 212.39 78.49 218.48 curveto
+76.77 220.49 75.35 223.17 76.03 225.88 curveto
+76.88 228.25 79.75 228.59 81.92 228.60 curveto
+94.12 228.46 106.66 227.77 118.47 231.46 curveto
+136.22 236.50 153.93 241.76 171.35 247.88 curveto
+closepath
+0.000 0.000 0.000 setrgbcolor
+fill
+%%EOF