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.