diff options
author | Samy Pesse <samypesse@gmail.com> | 2016-02-29 21:50:48 +0100 |
---|---|---|
committer | Samy Pesse <samypesse@gmail.com> | 2016-02-29 21:50:48 +0100 |
commit | c08e5ce62c30cb8d014151448bfe6da6b5a47fcf (patch) | |
tree | fd9504c00d46786aebe2c65c6a95fa62edb363a7 /docs/conrefs.md | |
parent | ec353e179dedf1ebf1ab6e54f6217a88d087ea75 (diff) | |
download | gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.zip gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.tar.gz gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.tar.bz2 |
Improve structure of doc
Diffstat (limited to 'docs/conrefs.md')
-rw-r--r-- | docs/conrefs.md | 55 |
1 files changed, 0 insertions, 55 deletions
diff --git a/docs/conrefs.md b/docs/conrefs.md deleted file mode 100644 index 7844e9c..0000000 --- a/docs/conrefs.md +++ /dev/null @@ -1,55 +0,0 @@ -# Content References - -Content referencing (conref) is a convenient mechanism for reuse of content from other files or books. - -### Importing local files - -Importing an other file's content is really easy using the `include` tag: - -``` -{% include "./test.md" %} -``` - -### Importing file from another book - -GitBook can also resolve the include path by using git: - -``` -{% include "git+https://github.com/GitbookIO/documentation.git/README.md#0.0.1" %} -``` - -The format of git url is: - -``` -git+https://user@hostname/project/blah.git/file#commit-ish -``` - -The real git url part should finish with `.git`, the filename to import is extracted after the `.git` till the fragment of the url. - -The `commit-ish` can be any tag, sha, or branch which can be supplied as an argument to `git checkout`. The default is `master`. - -### Inheritance - -Template inheritance is a way to make it easy to reuse templates. When writing a template, you can define "blocks" that child templates can override. The inheritance chain can be as long as you like. - -`block` defines a section on the template and identifies it with a name. Base templates can specify blocks and child templates can override them with new content. - -``` -{% extends "./mypage.md" %} - -{% block pageContent %} -# This is my page content -{% endblock %} -``` - -In the file `mypage.md`, you should specify the blocks that can be extent: - -``` -{% block pageContent %} -This is the default content -{% endblock %} - -# License - -{% import "./LICENSE" %} -``` |