What's all this? You're currently viewing the articles that make up the Knowledge Base. It's all built on Jekyll, a static website generator we use.
Want to help contribute to the Knowledge base? Write or update an article!
- The guides must be clear and well explained for the user to understand.
- Fact check and make sure the information you're providing is accurate.
- Proofread for any grammatical and spelling mistakes.
- Validate markdown and html syntax.
- Provide proper frontmatter.
- Use valid links and images.
- Make sure guides are up-to-date.
- The
_draftsfolder is where all previous articles from the old help center are stored. They only serve as a references and should be deleted once the article is re-created. - The
contentfolder is where all the content is hosted, any files changed here will automatically be pushed to the knowledge base._categoriesis where all the categories (such as Dashboard and Java) are stored, each grouped within its own section folder (e.g: Falix, Minecraft)._postsis where all the articles are stored. The folder structure begins with the section (e.g: Falix, Minecraft) and then category (e.g: Dashboard, Java) and finally subcategory (e.g: General).
When creating an article, create a .md file under the correct section, category and sub-category folders. As an example, if you were to create an article that explains how to install and use a plugin in Minecraft Java, the file would be created as such: content/_posts/minecraft/modification/plugins/yyyy-mm-dd-plugin-name.md. You're required to add the date at the beginning of the file name in the YYYY-MM-DD format. These dates are used to show when the article was last updated, so that users are aware if an article is up-to-date.
Articles are written in Markdown. Writing in Markdown is very easy to do. If you need help understanding how to do certain tasks, like creating a link, inserting an image or creating a list, look here.
If you wish to add an alternate version of a guide for a different Minecraft edition (Java or Bedrock). Use a replica of the other title and permalink with the corresponding category (Java or Bedrock) switched.
The frontmatter is the block at the top of every article surrounded by a pair of triple dashes ---. As the frontmatter is based on YAML, ensure that the correct syntax is followed:
---
title: "Title of Article"
tags: General
description: "Here is the description of your guide"
keywords:
- keyword: "dynmap"
- keyword: "world"
matches: ["live", "browser", "map"]
permalink: /minecraft/java/general/name-of-article
image: "link"
author: Name
---| Metadata | Description |
|---|---|
layout: |
(Optional, always set to post) |
title: |
The title of your guide, make sure it contains the necessary keywords to make it stand out |
category: |
(Optional, must match any of the categories category: front matter value in the content/_categories/ folder (Case sensitive)) |
tags: |
Any sub-category; they are each listed in their corresponding category file in the content/_categories/ folder. (Case sensitive) |
description: |
A description for your guide, keep it concise, informative and interesting |
keywords: |
All keywords relevant to the topic. Keywords without a "matches" key will be used as a standalone search query while those with the key will be combined to form a more accurate query. |
permalink: |
/section/category/sub-category/short-title (Lowercase) |
image: |
A direct link to an image to be used as a thumbnail (Optional) |
author: |
Name of the current author and maintainer. For multiple authors (maximum of 3), use the the array format. |
icon: |
Direct link to an icon. (Optional) |
toc: |
Whether to enable table of contents or not. (Optional, default value is true) |
Encompass your values in quotation marks if it contains symbols other than slashes
/or hyphens-. New authors must request for their github account to be manually added to display correct profile pictures.
The below frontmatter options are extra options for Minecraft modifications and addons (plugins, mods and data-packs) in addition to the default options:
---
icon: "link"
mod-name: "Name of mod"
mod-type: "Plugin, Mod, Standalone"
mod-url: "link"
---| Metadata | Description |
|---|---|
icon: |
Direct link to the mod's icon |
mod-name: |
Official mod name |
mod-type: |
The software type, such as plugin, mod, standalone, etc |
mod-url: |
A link to the mod's official page or website |
If you wish to include a post from an existing category in the Getting started category, use these extra frontmatter options:
---
getting-started-tag: General
post_order: 1
---| Metadata | Description |
|---|---|
getting-started-tag |
Functionally the same as tags: but specific to the getting started category only |
post_order |
Order of the post within the Getting-started category |
Using "# Title of Article" isn't needed; the layout will automatically add the title of the article to the top of the guide. That being said, always use "## Subtitle" instead.
We have a built in recommended icon and a few server software icons you can use anywhere in your article, we suggest using them in tabs as much as possible.
To display a recommended icon, use the code below:
<i class="recommended"></i>To display a server software icon, use the code below while replacing the classes with any supported class as is listed underneath it:
<i class="software software-name"></i>Replace software with either java-software, bedrock-software or type-software (mod, plugin, datapack).
Replace software-name with any supported software:
- Java:
java,snapshot,spigot,paper,pufferfish,purpur,fabric,neoforge,forge,quilt,sponge,mohist,magma,arclight,velocity,bungeecord - Bedrock:
bedrock,preview,pmmp,nukkit - Type:
mod,plugin,datapack
If you're adding an image to the files, follow the structure below:
Replace Alt text with alternative text in case the image is not loaded properly or for accessibility purposes. ... must also be replaced with the actual path of your image, including the file name and extension.
When typing out steps using lists, make sure to separate each step with a blank line. Otherwise, a <p> tag will not be generated.
When navigating around the Dashboard, four colors (Orange, Green, Red, Blue) can often be seen on different buttons such as Restart, Save File, Delete, Connect, etc. It is a good idea to color these words with the same color as can be seen in the Dashboard to make the guides more user friendly and vibrant. This can be done by making the word bold (** **) and immediately following it with an inline attribute with the color as a style name:
**Connect**{: .blue } **Delete**{: .red } **Restart**{: .orange } **Save File**{: .green }
In certain articles, you may want to use tabs to group separate alternate procedures in one place, such as procedures on configuring a software with a plugin and mod version:
{% tabs software %}
{% tab software plugin %}
Steps for the plugin go here
{% endtab %}
{% tab software mod %}
Steps for the mod go here
{% endtab %}
{% endtabs %}
The first word after the tab keyword is used to group the tabs together, while the words after will be displayed as the tab label. If the content of tabs have a similar structure, place the tabs under each heading rather than placing headings in tabs.
To add icons, simply paste the code before or after the tab label (e.g: {% tab software Paper <i class="recommended"></i> %}).
There are 4 custom blockquotes, which are each used in different context:
Note:
Used to add additional information that does not fit in its own paragraph.
> hi this is blockquoteSuccess:
Used to signify success messages or completion.
{: .success}
> hi this is blockquoteWarning:
Used as a warning to avoid something.
{: .warning}
> hi this is blockquoteError:
Used as a way to display common errors or issues.
{: .error}
> hi this is blockquoteLearn how to embed a YouTube video
<video controls preload="auto"><source src="https://example.com/video.webm" type="video/webm" src="https://example.com/video.mp4" type="video/mp4" /></video>If you're adding a video to the files, use a path like
content/assets/videos/posts/....
Make sure to provide both WebM and MP4. WebM videos are much smaller and load faster, although an MP4 is required too because not all browsers support the WebM format. So, the MP4 is more of a fallback option if the user's browser doesn't like WebM.
Create a pull request in this repo and title it using the following format: "New: Name of Article" or if you're editing an article, title it like "Edit: Name of Existing Article".
Your edit will be reviewed by our support team along with your code to check for any syntax errors.
All PRs are closed if inactive for a long period of time, usually about 3 weeks to a month.