By William Jeffrey Rankin, Sat Nov 29 2025
Have you just downloaded Hua and are wondering how to get started? Here's how you can create your first article!
First, copy and paste the code of this minimal article into a file named hua-first.md. Put the file in Hua's content directory.
Next, open entries.csv in Hua's root directory in a text editor and add this line to the end of the file:
000050,My First Article!,hua-first.md,tag|another,11/29/2025,Author Name,mailto:someone@email.com
Now open meta.csv and add this line (this step is optional, by the way):
000050|tag, article, Hua|This is my first article!
You're nearly there! Open a command shell or terminal, navigate to the Hua directory, and type the following:
pwsh hua.ps1 example.cfg
The output will look something like this. Don't worry about the errors (unless it mentions your article specifically) — these are present to demonstrate Hua's error handling.
Content file error. File (ID: 000047) is empty. Skipping.
Content file error. File (ID: 000045) is empty. Skipping.
Entries file error. There is an entry (ID: 000040) without a filename. Skipping.
Entry content error. Entry content file path set as .\content\missing-2.md. Skipping.
Entry content error. Entry content file path set as .\content\missing-1.html. Skipping.
Related article error in 000020. Article ID 000017 does not exist. Ignoring.
Entries file error. There is an entry without an ID. Skipping.
Finally, open the blog directory. It will contain the newly generated file, hua-first.html. The article will also appear in index.html, the tagged with files, and archive.html. That's it!