iskm/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2024-12-23 09:41:36 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Document changes to frontmatter format

Browse Source
This commit is contained in:
Boris Verkhovskiy 2024-12-09 06:24:46 -07:00
parent 688dbbb097
commit 761a061b7e
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
CONTRIBUTING.md
View File

@ -41,14 +41,14 @@ review them more effectively and/or individually.
### Header configuration ### Header configuration
The actual site uses Middleman to generate HTML files from these Markdown ones. The actual site generates HTML files from these Markdown ones.
Middleman, or at least the custom scripts underpinning the site, requires that The markdown files can contain extra metadata before the actual markdown,
some key information be defined in the header. called frontmatter.
The following fields are necessary for English articles about programming The following fields are necessary for English articles about programming
languages: languages:
* **language** The *programming language* in question * **name** The human-readable name of the programming language
* **contributors** A list of [author, URL] lists to credit * **contributors** A list of [author, URL] lists to credit
Other fields: Other fields:
@ -57,8 +57,9 @@ Other fields:
*tool* or *Algorithms & Data Structures*. Defaults to *language* if omitted. *tool* or *Algorithms & Data Structures*. Defaults to *language* if omitted.
* **filename**: The filename for this article's code. It will be fetched, mashed * **filename**: The filename for this article's code. It will be fetched, mashed
together, and made downloadable. together, and made downloadable.
* For non-English articles, *filename* will be used from the English article,
unless you want to overwrite it for some reason. Non-English articles inherit frontmatter values from the English article (if it exists)
but you can overwrite them.
Here's an example header for Ruby: Here's an example header for Ruby: