Suggest an article on GitHub
To suggest a new article go to the /_articles directory of the ModDota GitHub
Note: You need to be logged in to your GitHub account for this.
Next, click the 'Create file' button as indicated:
Fill your article
In the new file window you have to add a descriptive file name and text for your article:
Tip: You can use the preview tab at the top to preview the article!
IMPORTANT: Mandatory fields
There are some mandatory fields you need to fill for the article to work:
First, you need to set a file name. Choose a descriptive name, words separated by
- (no spaces). The file must end with .md!
Second, you need to set some basic article information at the top, the layout is always the same (including dashes):
The only required field is
title, all other fields can be safely omitted.
Submit your article for review
Once you're done you just need to add a very short description on the tutorial you just made at the bottom of the page. This will show up in the change history of the website. Once you are done hit the green 'Propose new file' button.
Someone will check if the article is not broken on the website and is not missing information, you might be asked to make some changes before the page is added to the website.
Once your tutorial is merged it is automatically released to the website.
Tutorials can be written in Markdown markup language, with some extra features from GitHub Flavored Markdown supported. To get familiar with the syntax, you can visit this page.
In addition, this website supports markdown extensions provided by Docusaurus:
To add a Gfycat gif to the page use the following format:
<Gfycat id="remarkableimportantant" />
To add a YouTube player to the page use the following:
<YouTube id="GMvmdnNM6Sc" />
In Docusaurus, Markdown's [headings] get an additional meaning - they are used to generate Table of Contents, which you can see on the right side from the article.
Only headings of levels 2 (##) and 3 (###) would appear in the Table of Contents.
Do not use headings of the first level (#) in tutorials. It would be automatically added based on the
Using a git fork
Warning: Advanced users only
This website is set up as a Github Pages project which is automatically rendered from its source contents by Jekyll. Content is rendered automatically after each push to master and published to the website.
You can simply fork or clone the repository to edit the files and submit a pull request to the main repository.
File structure is as follows: