43 lines
1006 B
Markdown
43 lines
1006 B
Markdown
# Doc-generator
|
|
|
|
Here is the documentation of the language in markdown, and a program to
|
|
generate static HTML files from them.
|
|
|
|
## `src` folder
|
|
|
|
Rust code to generate HTML files from MD files.
|
|
|
|
The binary is called like:
|
|
|
|
```sh
|
|
generator --input /path/to/markdown/folder/ --output /path/to/static/folder
|
|
```
|
|
|
|
## `markdown` folder
|
|
|
|
Contains the Markdown. All files inside are expected to be UTF-8 encoded
|
|
markdown, and have the `.md` file extension.
|
|
|
|
## `static` folder
|
|
|
|
Contains CSS, JS, and HTML templates. Here the MD files are written to
|
|
after being converted.
|
|
|
|
There must be a `template.html` file inside this folder. This file will be used to generate the HTML from MD files.
|
|
|
|
Inside `template.html` there must be a string `{{markdown}}`:
|
|
|
|
```html
|
|
<!-- Some html -->
|
|
{{markdown}}
|
|
<!-- More html -->
|
|
```
|
|
|
|
This string, `{{markdown}}`, will be replaced with the HTML generated
|
|
from Markdown
|
|
|
|
## `dist` folder
|
|
|
|
Coming soon, this folder will contain all HTML, CSS & JS minified after
|
|
running a script.
|