Glenn Y. Rolland
434c3d72e0
All checks were successful
continuous-integration/drone/push Build is passing
60 lines
878 B
Markdown
60 lines
878 B
Markdown
# DocMachine
|
|
|
|
## Prerequisites
|
|
|
|
Make sure you have Docker installed.
|
|
|
|
## Writing content
|
|
|
|
### Create your directory tree
|
|
|
|
```
|
|
. # project directory
|
|
|- docs # where website documents go
|
|
| `- *.md
|
|
|- slides # where presentation documents go
|
|
| `- *.md
|
|
|- images/ # where images go
|
|
|- ...
|
|
```
|
|
|
|
### Content for docs
|
|
|
|
FIXME: tree structure
|
|
|
|
FIXME: autoslide feature
|
|
|
|
### Content for slides
|
|
|
|
FIXME: tree structure
|
|
|
|
## Watch mode
|
|
|
|
This mode allows you the result on-the-fly as you makea changes in the content.
|
|
|
|
To use watch mode, type:
|
|
|
|
docmachine -a watch
|
|
|
|
To use watch mode for slides only type:
|
|
|
|
docmachine -a watch-slides
|
|
|
|
To use watch mode for docs only type:
|
|
|
|
docmachine -a watch-docs
|
|
|
|
|
|
## Build mode
|
|
|
|
This mode builds final content for delivery (website, PDF files)
|
|
|
|
### Building HTML
|
|
|
|
To use build mode:
|
|
|
|
docmachine build
|
|
|
|
### Building PDF
|
|
|
|
|