d3v/D3V-Server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
D3V-Server/blog-starter/README.md

2.2 KiB
Raw Blame History

Blog Starter

This folder is a standalone starter for a Hugo blog that uses the LoveIt theme and deploys to the static blog host installed by install.sh.

What This Starter Includes

  • Hugo site structure
  • LoveIt bootstrap script
  • sample content
  • a helper script to create new posts
  • a Forgejo Actions workflow that builds and deploys to /opt/blog/public

Recommended Setup

Create a separate Git repository for your blog, then copy this starter into that repository root.

Local Writing Workflow

  1. Bootstrap the theme:
./scripts/bootstrap-theme.sh
  1. Create a new post:
./scripts/new-post.sh my-first-post
  1. Start the local preview server:
hugo server
  1. Edit the generated file under content/posts/.
  2. When ready to publish, set draft = false, commit, and push.

Forgejo Web Workflow

If you want to create posts directly from the Forgejo web UI, use the manual workflow in .forgejo/workflows/create-post.yml.

From the Actions page:

  1. Run Create Blog Post
  2. Fill in:
    • title
    • slug
    • optional summary
    • optional comma-separated tags
    • optional comma-separated categories
    • draft
  3. The workflow creates content/posts/<slug>.md
  4. The normal deploy workflow publishes the post on the next push

This keeps you out of front matter for most day-to-day writing.

Forgejo Secrets

The workflow expects these repository secrets:

  • BLOG_DEPLOY_HOST: server hostname or IP
  • BLOG_DEPLOY_PORT: SSH port, usually 22
  • BLOG_DEPLOY_USER: deploy user on the server
  • BLOG_DEPLOY_KEY: private SSH key for the deploy user
  • BLOG_DEPLOY_PATH: target directory, usually /opt/blog
  • BLOG_DEPLOY_KNOWN_HOSTS: optional known_hosts entry for stricter SSH

Expected Server State

  • Blog host installed from this repo's install.sh
  • d3v-blog container running
  • the deploy user can write to /opt/blog/public
  • Nginx Proxy Manager forwards blog.yourdomain.com to d3v-blog:80

Notes

  • This starter fetches LoveIt into themes/LoveIt using Git.
  • The workflow installs Hugo Extended before building.
  • Deployment uses rsync --delete to keep /opt/blog/public in sync with the latest generated public/ output.