Want to help contribute to the Help Center? Write or update an article!
- The communication must be clear and well explained for the user to understand
- Fact check and make sure the information you're providing is accurate
- Good grammar
- Valid syntax
- Proper metadata
By following the file structure, create a .md file under the correct category. As an example, if you were to create an article that explains on how to install and use a plugin on Minecraft Java, the file would be created like _posts_/minecraft/plugins/2021-08-04-plugin-name.md. You're required to add the date at the beginning of the file name, 2021-08-04. Then start writing the article in Markdown. Writing in Markdown is very easy to do, if you need help understanding how to do certain task like creating a link, inserting an image, creating a list look here.
Make sure the metadata is setup properly, this is usually at the top of every article. It should look like this:
---
layout: post
title: "Title of Article"
categories: Minecraft
tags: plugins
permalink: /minecraft/plugins/name-of-plugin/
---
layout must remain as post.
tags is the sub-category.
At the top of each plugin article, there is a box displays information about the plugin with a download link, example:
If you plan to create an article explaining how to use a plugin, it's best you use this at the top of the article. The code is:
<div class="install-plugin">
<img style="border-radius: 7px;" src="">
<p>Name of Plugin</p>
<a href="#">Download this Plugin</a>
</div>
In the future, I plan to add more content to this custom HTML code like author, official website, last updated, etc.
# Header 1
## Header 2
### Header 3
#### Header 4
[FalixNodes](https://falixnodes.net/)
List:
- Item
- Item
- Item
- Item
- Item
- Item
- Item
- Item
Checklist:
- Item
- Item
- Item
- Item
- Item
- [x] Item
- [x] Item
- [ ] Item
- [ ] Item
- [ ] Item
A table is used to display content clearly without making a mess, like we did in the Getting Started article under Minecraft, showing a color code table.
Example:
| Example | List |
|---|---|
| Example | Content |
| Example | Content |
| Example | Content |
| Example | Content |
Code:
| Example | List |
|:---------------|:--------------|
| Example | Content |
| Example | Content |
| Example | Content |
| Example | Content |
I personally like seeing <video> in the help center over a YouTube embed, but you're allowed to use a YouTube embed if you want to.
Learn how to embed a YouTube video
We've added VideoJS script recently to the help center, which adds custom controls to the code.
So when adding videos to an article, make sure it looks like this:
<video class="video-js" controls preload="auto" data-setup="{}"><source
src="https://example.com/video.webm" type="video/webm"
src="https://example.com/video.mp4" type="video/mp4"
/></video>
Make sure to provide both webm and mp4. Webm are much smaller and load faster, although an MP4 file is required as not all browsers support webm format. So the MP4 is more of a fallback option if the user's browser doesn't like the webm format.
Create a pull request on this repo and title it like this "New Post: Name of Article" or if you're editing an article, title it like "Edit: Name of Existing Article".
Your edit will be reviewed by Korbs along with your code to check for any syntax error.
If you're interested in learning on how to build the Help Center locally, maybe to preview that your article does show up properly, just follow the instructions below.
Since the Help Center is powered by Jekyll, you'll need to install Ruby for your operating system.
Debian/Ubuntu:
sudo apt-get install ruby-full build-essential zlib1g-dev
gem install jekyll bundler
bundle install
Fedora/RedHat:
sudo dnf install make automake gcc gcc-c++ kernel-devel ruby-devel
gem install jekyll bundler
bundle install
To run a localhost server, run:
bundle exec jekyll serve
After using bundle exec jekyll serve, try going to http://localhost:4000/ in your preferred web browser.