This is the intro paragraph. It's the equivalent of the old introduction
yaml attribute, but instead of living in the YAML front matter, it now lives
in the document.
To write a brand new article, follow these steps. Or simply make a copy of this markdown file, place it in the directory you want, and edit away.
YAML Front Matter
All documents need to have a minimum set of YAML front matter including a link
to the _project.yaml
, and one to the _book.yaml
.
project_path: /web/_project.yaml
book_path: /web/section/_book.yaml
Description (optional)
You can provide a page description in the YAML front matter that is used as the
meta
description for the page. The description should be short (<450 char),
and only provide a brief synopsis of the page.
description: Lorem ipsum
Other YAML Attributes
See YAML Front Matter and Attribute Reference for all of the YAML Front Matter and other attributes you can or should use.
Page Title (required)
The page title is defined by the first H1-like tag with the .page-title
class.
For example:
# Writing an Article {: .page-title }
Author and Translator Attribution
To include an author or translator attribution, use:
{% include "web/_shared/contributors/petelepage.html" %}
Write Your Content
Next, it's time to add your content. Refer to the writing style guide and markdown syntax guide for full details on the styles you can use and how to go about making stuff look pretty.
Add Article to the Book
To get your article to appear in the appropriate navigation, you need to update
the _book.yaml
or _toc.yaml
file. Each section (updates, shows, fundamentals),
has it's own _book.yaml
and which links to individual _toc.yaml
files.
You most likely want to add your article to one of the _toc.yaml
files.
Test and Submit Your PR
When you're ready, run gulp test
to make sure that there are no issues with
your content, then submit your pull request.