diff options
Diffstat (limited to 'docs/modules/extend')
| -rw-r--r-- | docs/modules/extend/pages/index.adoc | 2 | ||||
| -rw-r--r-- | docs/modules/extend/pages/use-cases.adoc | 9 |
2 files changed, 6 insertions, 5 deletions
diff --git a/docs/modules/extend/pages/index.adoc b/docs/modules/extend/pages/index.adoc index cdf09ec7..72ae7b4a 100644 --- a/docs/modules/extend/pages/index.adoc +++ b/docs/modules/extend/pages/index.adoc @@ -15,7 +15,7 @@ Once you feel comfortable with Prawn, you're ready to extend the converter. == Going beyond theming -While creating the PDF document, there are thousands of small decisions the converter must make about how to instruct Prawn to layout the content elements on the page (so-called "`hackable typesetting`"). +While creating the PDF document, there are thousands of small decisions the converter must make about how to instruct Prawn to lay out the content elements on the page (so-called "`hackable typesetting`"). But once these elements are written, they can't be moved or styled (as is the case with HTML and CSS). To help influence those decisions--and thus prevent the converter from becoming too opinionated, a theming system was introduced. diff --git a/docs/modules/extend/pages/use-cases.adoc b/docs/modules/extend/pages/use-cases.adoc index 21bbb76a..a8c86fa6 100644 --- a/docs/modules/extend/pages/use-cases.adoc +++ b/docs/modules/extend/pages/use-cases.adoc @@ -128,7 +128,7 @@ For example: == License page -Let's so you want to insert a license page into your documents, but you don't want to have to put a block macro for it in the document source. +Let's say you want to insert a license page into your documents, but you don't want to have to put a block macro for it in the document source. You can use an extended converter to add new pages to the body of the document. Let's consider the case of reading the license text from a file and inserting it into the first page of the body. @@ -146,7 +146,7 @@ You may want to take this a bit further and allow the location of the license fi == Paragraph numbering -To help with content auditing or coorelation, you may want to add a number in front of each paragraph. +To help with content auditing or correlation, you may want to add a number in front of each paragraph. You can do this first by assigning a number to each paragraph in the document in the `init_pdf` method. Then, you can add this number in the left margin at the start of each paragraph by overriding the `convert_paragraph` method. @@ -214,7 +214,7 @@ Once this limit is reached, the converter will not call `get_entries_for_toc` fo == Narrow TOC Let's say you want to make the content on the TOC page(s) really narrow. -You can do so by overridding the `ink_toc` method and squeezing the margins by applying extra indentation. +You can do so by overriding the `ink_toc` method and squeezing the margins by applying extra indentation. .Extended converter with narrow TOC [,ruby] @@ -270,6 +270,7 @@ You're free to customize where the label is placed. The float method allows you to move the cursor around in absolute space without impacting the flow of the content. The extent gives you the information about the location of the code block. +[#wrap-code-blocks-around-image] == Wrap code blocks around an image float Asciidoctor PDF provides basic support for image floats. @@ -361,7 +362,7 @@ The columns get applied to the body of the document, which excludes the document The Asciidoctor PDF converter also provides the framework for making multi-column layouts in an extended converter. This framework is accessible via the helper method `column_box`. -To make a muti-column layout, you put statements that ink content inside a code block and pass it to the `column_box` method as follows: +To make a multi-column layout, you put statements that ink content inside a code block and pass it to the `column_box` method as follows: [,ruby] ---- |