Add templating doc skeleton

README.md

@@ -27,8 +27,9 @@ Manage your dotfiles across multiple machines, securely.
 
 [Install chezmoi](docs/INSTALL.md) then read the [quick start
 guide](docs/QUICKSTART.md). The [how-to guide](docs/HOWTO.md) covers most common
-tasks, and there's the [frequently asked questions](docs/FAQ.md) for specific
-questions. You can browse other people's dotfiles that use chezmoi [on
+tasks, and there's both documentation on [templating](docs/TEMPLATING.md) and
+[frequently asked questions](docs/FAQ.md) for specific questions. You can browse
+other people's dotfiles that use chezmoi [on
 GitHub](https://github.com/topics/chezmoi?o=desc&s=updated) and [on
 GitLab](https://gitlab.com/search?search=chezmoi). For a full description of
 chezmoi, consult the [reference](docs/REFERENCE.md).
@@ -190,6 +191,7 @@ Read what [people have said about chezmoi](docs/MEDIA.md).
   one or two commands.
 * [Quick start guide](docs/QUICKSTART.md) for your first steps.
 * [How-to guide](docs/HOWTO.md) for achieving specific tasks.
+* [Templating guide](docs/TEMPLATING.md) for working with templates.
 * [FAQ](docs/FAQ.md) for questions that aren't answered elsewhere.
 * [Changes](docs/CHANGES.md) for non-backwards compatible changes.
 * [Reference](docs/REFERENCE.md) for a complete description of chezmoi.

chezmoi.io/Makefile

@@ -11,7 +11,8 @@ content-docs: \
 	content/docs/install.md \
 	content/docs/media.md \
 	content/docs/quick-start.md \
-	content/docs/reference.md
+	content/docs/reference.md \
+	content/docs/templating.md
 
 content/docs/changes.md: ../docs/CHANGES.md ../internal/generate-chezmoi.io-content-docs/main.go Makefile
 	go run ../internal/generate-chezmoi.io-content-docs -shorttitle="Changes" -longtitle="Changes" < $< > $@ || ( rm -f $@ ; false )
@@ -36,3 +37,6 @@ content/docs/quick-start.md: ../docs/QUICKSTART.md ../internal/generate-chezmoi.
 
 content/docs/reference.md: ../docs/REFERENCE.md ../internal/generate-chezmoi.io-content-docs/main.go Makefile
 	go run ../internal/generate-chezmoi.io-content-docs -shorttitle="Reference" -longtitle="Reference Manual" < $< > $@ || ( rm -f $@ ; false )
+
+content/docs/templating.md: ../docs/TEMPLATING.md ../internal/generate-chezmoi.io-content-docs/main.go Makefile
+	go run ../internal/generate-chezmoi.io-content-docs -shorttitle="Templating" -longtitle="Templating Guide" < $< > $@ || ( rm -f $@ ; false )

chezmoi.io/content/_index.md

@@ -9,10 +9,11 @@ Manage your dotfiles across multiple machines, securely.
 
 ## How do I start with chezmoi now?
 
-[Install chezmoi](/docs/install/) then read the [quick start
-guide](/docs/quick-start/). The [how-to guide](/docs/how-to/) covers most common
-tasks, and there's the [frequently asked questions](/docs/faq/) for specific
-questions. You can browse other people's dotfiles that use chezmoi [on
+[Install chezmoi](docs/INSTALL.md) then read the [quick start
+guide](docs/QUICKSTART.md). The [how-to guide](docs/HOWTO.md) covers most common
+tasks, and there's both documentation on [templating](docs/TEMPLATING.md) and
+[frequently asked questions](docs/FAQ.md) for specific questions. You can browse
+other people's dotfiles that use chezmoi [on
 GitHub](https://github.com/topics/chezmoi?o=desc&s=updated) and [on
 GitLab](https://gitlab.com/search?search=chezmoi). For a full description of
 chezmoi, consult the [reference](/docs/reference/).
@@ -61,7 +62,7 @@ the configuration file in the format of your choice. chezmoi can retrieve
 secrets from [1Password](https://1password.com/),
 [Bitwarden](https://bitwarden.com/), [gopass](https://www.gopass.pw/),
 [KeePassXC](https://keepassxc.org/), [LastPass](https://lastpass.com/),
-[pass](https://www.passwordstore.org/), [Vault](https://www.vaultproject.io/),,
+[pass](https://www.passwordstore.org/), [Vault](https://www.vaultproject.io/),
 or any command-line utility of your choice. You can encrypt individual files
 with [GnuPG](https://www.gnupg.org). You can checkout your dotfiles repo on as
 many machines as you want without revealing any secrets to anyone.
@@ -174,6 +175,7 @@ Read what [people have said about chezmoi](docs/MEDIA.md).
   one or two commands.
 * [Quick start guide](/docs/quick-start/) for your first steps.
 * [How-to guide](/docs/how-to/) for achieving specific tasks.
+* [Templating guide](/docs/templating/) for working with templates.
 * [FAQ](/docs/faq/) for questions that aren't answered elsewhere.
 * [Changes](/docs/changes/) for non-backwards compatible changes.
 * [Reference](/docs/reference/) for a complete description of chezmoi.

chezmoi.io/content/docs/menu/index.md

@@ -5,6 +5,7 @@ headless = true
 - [Install]({{< relref "/docs/install.md" >}})
 - [Quick Start]({{< relref "/docs/quick-start.md" >}})
 - [How-To]({{< relref "/docs/how-to.md" >}})
+- [Templating]({{< relref "/docs/templating.md" >}})
 - [FAQ]({{< relref "/docs/faq.md" >}})
 - [Changes]({{< relref "/docs/changes.md" >}})
 - [Reference]({{< relref "/docs/reference.md" >}})

docs/TEMPLATING.md

@@ -0,0 +1,8 @@
+# chezmoi Templating Guide
+
+<!--- toc --->
+* [Placeholder](#placeholder)
+
+## Placeholder
+
+This document is a placeholder for improved template documentation.

main.go

@@ -1,4 +1,4 @@
-//go:generate go run ./internal/generate-assets -o cmd/docs.gen.go -tags=!noembeddocs docs/CHANGES.md docs/CONTRIBUTING.md docs/FAQ.md docs/HOWTO.md docs/INSTALL.md docs/MEDIA.md docs/QUICKSTART.md docs/REFERENCE.md
+//go:generate go run ./internal/generate-assets -o cmd/docs.gen.go -tags=!noembeddocs docs/CHANGES.md docs/CONTRIBUTING.md docs/FAQ.md docs/HOWTO.md docs/INSTALL.md docs/MEDIA.md docs/QUICKSTART.md docs/REFERENCE.md docs/TEMPLATING.md
 //go:generate go run ./internal/generate-assets -o cmd/templates.gen.go assets/templates/COMMIT_MESSAGE.tmpl
 //go:generate go run ./internal/generate-helps -o cmd/helps.gen.go -i docs/REFERENCE.md
 //go:generate go run . completion bash -o completions/chezmoi-completion.bash