1
0
Fork 0
mirror of https://github.com/lise-henry/crowbook synced 2024-06-01 18:06:27 +02:00

Update book_example/config.md

This commit is contained in:
Elisabeth Henry 2016-03-07 01:56:38 +01:00
parent c5ed1ab8d7
commit 42ef79876a

View File

@ -179,6 +179,10 @@ usage of some of them is detailed later on.
- **type**: path
- **default value**: `not set`
- Output file name for HTML rendering
- **`output.html_dir`**
- **type**: path
- **default value**: `not set`
- Output directory name for HTML rendering
- **`output.tex`**
- **type**: path
- **default value**: `not set`
@ -193,7 +197,23 @@ usage of some of them is detailed later on.
- Output file name for ODT rendering
### Resources option ###
- **`resources.path`**
- **`resources.base_path`**
- **type**: path
- **default value**: `not set`
- Path where to find resources (in the source tree). By default, links and images are relative to the Markdown file. If this is set, it will be to this path.
- **`resources.base_path.links`**
- **type**: path
- **default value**: `not set`
- Set base path but only for links. Useless if resources.base_path is set.
- **`resources.base_path.images`**
- **type**: path
- **default value**: `.`
- Set base path but only for images. Useless if resources.base_path is set.
- **`resources.base_path.files`**
- **type**: path
- **default value**: `.`
- Set base path but only for additional files. Useless if resources.base_path is set.
- **`resources.out_path`**
- **type**: path
- **default value**: `data`
- Paths where additional resources should be copied in the EPUB file or HTML directory
@ -203,18 +223,6 @@ usage of some of them is detailed later on.
- Whitespace-separated list of files to embed in e.g. EPUB file
### Misc options ###
- **`base_path`**
- **type**: path
- **default value**: `not set`
- By default, links and images are relative to the Markdown file. If this is set, it will be to this path.
- **`base_path.links`**
- **type**: path
- **default value**: `not set`
- Set base path but only for links. Useless if base_path is set.
- **`base_path.images`**
- **type**: path
- **default value**: `not set`
- Set base path but only for images. Useless if base_path is set.
- **`enable_yaml_blocks`**
- **type**: boolean
- **default value**: `false`
@ -269,6 +277,24 @@ usage of some of them is detailed later on.
- **type**: path
- **default value**: `not set`
- Path of a stylesheet to use with HTML rendering
- **`html.script`**
- **type**: path
- **default value**: `not set`
- Path of a javascript file
### Multifile HTML options ###
- **`html_dir.css`**
- **type**: path
- **default value**: `not set`
- Path of a CSS template
- **`html_dir.index.html`**
- **type**: path
- **default value**: `not set`
- Path of index.html template
- **`html_dir.chapter.html`**
- **type**: path
- **default value**: `not set`
- Path of a chapter.html template
### EPUB options ###
- **`epub.version`**
@ -288,8 +314,7 @@ usage of some of them is detailed later on.
- **`tex.short`**
- **type**: boolean
- **default value**: `false`
- If set to true, use article class instead of book and a the
default `\maketitle` command
- If set to true, use article class instead of book and a the default `\maketitle` command
- **`tex.links_as_footnotes`**
- **type**: boolean
- **default value**: `true`
@ -303,7 +328,20 @@ usage of some of them is detailed later on.
- **default value**: `not set`
- Path of a LaTeX template file
### Deprecated options ###
- **`base_path`**
- **type**: DEPRECATED
- **default value**: `resources.base_path`
- Renamed
- **`base_path.links`**
- **type**: DEPRECATED
- **default value**: `resources.base_path.links`
- Renamed
- **`base_path.images`**
- **type**: DEPRECATED
- **default value**: `resources.base_path.images`
- Renamed
Note that these options have a type, which in most case should be
pretty straightforward (a boolean can be `true` or `false`, an integer
must be composed a number, a string is, well, any string). The `path`
@ -351,6 +389,14 @@ so PDF rendering won't work if it is not installed on your
system. Crowbook also uses the `zip` command to generate the EPUB and
ODT, files.
Current output options are:
* `output.html`: renders a standalone HTML file;
* `output.html_dir`: render a HTML directory with one page by chapter;
* `output.epub`: renders an EPUB file;
* `output.tex`: renders a LaTeX file;
* `output.pdf`: renders a PDF file (using `tex.command`);
### Resources options ###
These two options allow to embed additional files for some formats