Signal & Silence

A Hugo-powered personal blog for projects, personal essays, and Mandarin learning notes.

New here? Read the complete blog operating guide for the blogger's idea-to-publication workflow and the practical commands, then follow the hands-on practice tutorial.

Write a new post

Create a personal essay:

npm run new:personal -- personal/my-post-name.md

Create a project note:

npm run new:project -- project/my-project-name.md

Create a Chinese-learning note:

npm run new:language -- languages/my-note-name.md

Open the new Markdown file in content/project/, content/personal/, or content/languages/, change draft: true to draft: false, and write below the front matter. New posts automatically appear in the correct blog list.

Project posts are written in English. Personal and Languages posts are written in Vietnamese.

Preview and build

npm install
npm run dev
npm run build

Publish

For the first deploy, open the repository's Settings → Pages and set Source to GitHub Actions.

After that, push to the main branch. The workflow in .github/workflows/hugo.yml installs the pinned dependencies, builds Hugo with the repository's Pages base URL, uploads the generated site, and deploys it. Every later push to main publishes automatically; the workflow can also be started manually from the Actions tab.