[v0.1.0] - Add Table of Contents

pull/3/head
sgoudham 2 years ago
parent 080defaadf
commit 417a69affa
Signed by: hammy
GPG Key ID: 44E818FD5457EEA4

@ -9,7 +9,17 @@
## Table of Contents ## Table of Contents
TODO - [mdbook-template](#mdbook-template)
* [Table of Contents](#table-of-contents)
* [Author Notes](#author-notes)
* [Installation](#installation)
* [About](#about)
* [Format](#format)
* [Valid Configurations](#valid-configurations)
* [Example](#example)
* [License](#license)
* [Contributing](#contributing)
* [Acknowledgement](#acknowledgement)
## Author Notes ## Author Notes
@ -77,48 +87,38 @@ The format is as follows
3. Any arguments that should be substituted within the template file. Arguments should be seperated by whitespace and 3. Any arguments that should be substituted within the template file. Arguments should be seperated by whitespace and
should be in the `key=value` format. should be in the `key=value` format.
Arguments to be replaced within the template files should be wrapped in `{}` Arguments to be replaced within the template files should be wrapped in `{}`
## Valid Configurations ## Valid Configurations
```markdown ```markdown
# Valid # Valid
{{#template file.txt path=../images author=Goudham}} {{#template file.txt path=../images author=Goudham}}
# Valid # Valid
{{#template
file.txt {{#template file.txt path=../images author=Goudham }}
path=../images
author=Goudham
}}
# Valid # Valid
// Not recommended but valid
{{#template file.txt path=../images author=Goudham}} // Not recommended but valid {{#template file.txt path=../images author=Goudham}}
# Valid # Valid
// Not recommended but valid
{{#template // Not recommended but valid {{#template file.txt path=../images author=Goudham }}
file.txt
path=../images
author=Goudham
}}
# Invalid # Invalid
// Use {{#include}} for simply including files
{{#template file.txt}} // Use {{#include}} for simply including files {{#template file.txt}}
# Invalid # Invalid
{{#template
file.txt {{#template file.txt path=../images author=Goudham}}
path=../images
author=Goudham}}
# Invalid # Invalid
{{#template file.txt
path=../images {{#template file.txt path=../images author=Goudham }}
author=Goudham
}}
``` ```
## Example ## Example
@ -143,6 +143,7 @@ src
and the following content and the following content
`templates/footer.md` `templates/footer.md`
```markdown ```markdown
-- Designed By {authors} -- -- Designed By {authors} --
![ferris]({path}/ferris.png) ![ferris]({path}/ferris.png)
@ -150,39 +151,43 @@ and the following content
``` ```
`rust.md` `rust.md`
```markdown ```markdown
# Rust # Rust
Some Content... Some Content...
{{#template templates/footer.md authors=Goudham, Hazel path=images}} {{#template templates/footer.md authors=Goudham, Hazel path=images}}
``` ```
`go.md` `go.md`
```markdown ```markdown
# Go # Go
Some Content... Some Content...
{{#template templates/footer.md path=images authors=Goudham, Hazel}} {{#template templates/footer.md path=images authors=Goudham, Hazel}}
``` ```
`friends/hazel.md` `friends/hazel.md`
```markdown ```markdown
# Hazel # Hazel
Some Content... Some Content...
{{#template {{#template ../templates/footer.md path=../images authors=Goudham, Hazel }}
../templates/footer.md
path=../images
authors=Goudham, Hazel
}}
``` ```
After running `mdbook build` with the mdbook-template preprocessor enabled, the files will have dynamic paths to the After running `mdbook build` with the mdbook-template preprocessor enabled, the files will have dynamic paths to the
images and contain **_identical_** content. images and contain **_identical_** content.
`rust.md` `rust.md`
```markdown ```markdown
# Rust # Rust
Some Content... Some Content...
-- Designed By Goudham, Hazel -- -- Designed By Goudham, Hazel --
@ -191,8 +196,10 @@ Some Content...
``` ```
`go.md` `go.md`
```markdown ```markdown
# Go # Go
Some Content... Some Content...
-- Designed By Goudham, Hazel -- -- Designed By Goudham, Hazel --
@ -201,8 +208,10 @@ Some Content...
``` ```
`friends/hazel.md` `friends/hazel.md`
```markdown ```markdown
# Hazel # Hazel
Some Content... Some Content...
-- Designed By Goudham, Hazel -- -- Designed By Goudham, Hazel --

Loading…
Cancel
Save