Skip to main content

Write Tutorials

Follow this guide if you want to write tutorials for Archcraft...

Prerequisite

  • Setup the local development environment, If you want to work locally.
  • You should have the basic understanding of the syntax of Markdown and MDX. See Docusaurus Markdown Features.
  • You, at least know how to fork, clone a repository and create a pull request.

Files and format

The blog directory contains all the .md and .mdx files for tutorials.

  • To add a new tutorial, just create a new file with the correct format.
  • The Format is important here, The format structure is :
YEAR                          # Directory
├── month-date-post-NAME.mdx # .md or .mdx file
└── month-date # Directory
├── Images # Directory
└── post-NAME.mdx # .md or .mdx file

Title and tags

Add appropriate slug, title and tags in the front matter of the file you create.

---
slug: NUM-post-NAME
title: TITLE FOR THE POST
authors: ID
tags: [TAG1, TAG2]
---

Author

Add your details in the file authors.yml and add your ID in the front matter of the file you created.

authors.yml

...
ID:
name: YOUR_NAME
title: ABOUT_YOU
url: https://github.com/USERNAME
image_url: https://github.com/USERNAME.png
...

Front matter

slug: NUM-post-NAME
title: TITLE FOR THE POST
authors: ID
tags: [TAG1, TAG2]

For more info, visit Docusaurus:Blog