Skip to main content

Contest Content Template Usage Guide

Step 1​

Fork Heltec Wi-Ki repository, and clone the forked project into local. Copy the contest-content-template file in the news folder, rename it into your project name, lowercase, spaces are replaced by -.

Enter the folder and change the name of "contest-content-template.md" to the same as the parent directory.

Now your folder structure should look like this

Heltec_Docs_News/
β”œβ”€β”€ docs/ # Document Directory
β”‚ β”œβ”€β”€ devices/ # Wiki Document 1
β”‚ β”œβ”€β”€ platform/ # Wiki Document 2
β”‚ β”œβ”€β”€ intro.md
β”‚ └── platforms.md
β”‚
β”œβ”€β”€ news/ # Document Directory
β”‚ β”œβ”€β”€ my-project-name/ # Wiki Document 1
β”‚ β”‚ β”œβ”€β”€ img/
β”‚ β”‚ β”‚ β”œβ”€β”€ 01.svg
β”‚ β”‚ β”‚ β”œβ”€β”€ 02.png
β”‚ β”‚ β”‚ β”œβ”€β”€ 03.png
β”‚ β”‚ β”‚ β”œβ”€β”€ 04.png
β”‚ β”‚ β”‚ └── ...
β”‚ β”‚ └── my-project-name.md # Wiki in subdirectories
β”‚ β”œβ”€β”€ contest-content-template/ # Wiki Document 1
β”‚ β”œβ”€β”€ contest-content-template-usage-guide/ # Wiki Document 2
β”‚ β”œβ”€β”€ 2025-Heltec-Maker-Contest.md
β”‚ β”œβ”€β”€ 2025-Heltec-Maker-Contest-Privacy-Policy.md
β”‚ β”œβ”€β”€ authors.yml
β”‚ └── tags.yml
β”‚
β”œβ”€β”€ scripts/
β”‚ └── ...
β”‚
β”œβ”€β”€ src/
β”‚ └── ...
└── ...

Step 2​

Now you can start creating your project in the my-project-name.md file. Put the relevent pictures into the img directory under my-project-name. Submit a PR to Heltec Wi-Ki repository, then wait for review. After the review is passed, your post will be displayed on Heltec News Page.