{"id":15154213,"url":"https://github.com/pythoninthegrass/hello_hugo","last_synced_at":"2025-10-24T10:30:48.476Z","repository":{"id":250027566,"uuid":"833265389","full_name":"pythoninthegrass/hello_hugo","owner":"pythoninthegrass","description":"Boilerplate for hugo static site with custom css/js","archived":false,"fork":false,"pushed_at":"2024-10-10T16:47:11.000Z","size":39,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T00:53:02.892Z","etag":null,"topics":["docker","golang","hugo","nginx","taskfile","webdev"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pythoninthegrass.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-24T17:22:05.000Z","updated_at":"2024-10-10T16:47:15.000Z","dependencies_parsed_at":"2024-07-24T20:39:25.472Z","dependency_job_id":null,"html_url":"https://github.com/pythoninthegrass/hello_hugo","commit_stats":null,"previous_names":["pythoninthegrass/hello_hugo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythoninthegrass%2Fhello_hugo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythoninthegrass%2Fhello_hugo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythoninthegrass%2Fhello_hugo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythoninthegrass%2Fhello_hugo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pythoninthegrass","download_url":"https://codeload.github.com/pythoninthegrass/hello_hugo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237950762,"owners_count":19392666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","golang","hugo","nginx","taskfile","webdev"],"created_at":"2024-09-26T17:04:28.465Z","updated_at":"2025-10-24T10:30:48.136Z","avatar_url":"https://github.com/pythoninthegrass.png","language":"Dockerfile","readme":"# hello_hugo\n\nAbsolute minimum to scaffold a Hugo static site with a [custom theme](https://gohugo.io/getting-started/quick-start/).\n\n(With some dev tooling added after the fact 😈)\n\n## Minimum Requirements\n\n* macOS or Linux\n* [Hugo](https://gohugo.io/getting-started/installing/)\n  * Linux: ignore package manager / snap packages, download latest [GitHub release](https://github.com/gohugoio/hugo/releases/)\n  * Make sure to get the extended version (e.g., `hugo_extended_0.129.0_linux-amd64.tar.gz`)\n\n## Recommended Requirements\n\n* [taskfile](https://taskfile.dev/#/installation)\n* [devbox](https://www.jetify.com/devbox/docs/quickstart/)\n\n## Quickstart\n\n```bash\n# clone repo\ngit clone https://github.com/pythoninthegrass/hello_hugo.git\ncd hello_hugo\n\n# clone theme submodule\n[ $(uname -s) == \"Darwin\" ] \u0026\u0026 procs=$(sysctl -n hw.ncpu) || procs=$(nproc)\ngit submodule update --init --recursive \u0026\u0026 git pull --recurse-submodules -j\"${procs}\"\n\n# add a new post\nhugo new posts/test-post.md\n\n# start hugo server (with hot reloading)\nhugo server\n\n# open browser to http://localhost:1313\n\n# stop hugo server\n# CTRL+C\n```\n\n## Customize\n\n### Fill out `.env` file\n\nProgrammatically generate the [hugo.toml](hugo.toml) via `python` and `devbox`.\n\nMinimum values in `.env`:\n\n| Key        | Default Value   |\n| ---------- | --------------- |\n| `BASE_URL` | `example.com`   |\n| `LANGUAGE` | `en-us`         |\n| `TITLE`    | `Hello, World!` |\n| `THEME`    | `ananke`        |\n\n### Generate `hugo.toml`\n\n```bash\ndevbox install\ncp .env.example .env\n# edit .env\ndevbox run gen-config\n```\n\n### Build\n\n```bash\nhugo\n```\n\n## Nginx + Docker\n\nIf deploying to `nginx`, add the following to `.env`:\n\n| Key         | Default Value     |\n| ----------- | ----------------- |\n| `NGINX_DIR` | `\u003c/var/www/html\u003e` |\n\nwhere `\u003c/var/www/html\u003e` is the path to the `nginx` root directory.\n\n### HTTP (Port 80)\n\nComment out the line in [docker-compose.yml](docker-compose.yml) that mounts the `nginx` [certs](nginx/certs) directory.\n\n```yaml\nvolumes:\n  - ./public:/var/www/public\n  # - ./nginx/certs:/etc/acme/certs/live/${BASE_URL}\n```\n\n### HTTPS (Port 443)\n\nGenerate certificates with either [acme.sh](https://github.com/acmesh-official/acme.sh) or [certbot](https://certbot.eff.org/).\n\nCopy the following files to the `nginx` [certs](nginx/certs) directory:\n\n* `fullchain.pem`\n* `privkey.pem`\n* `ssl-dhparams.pem`\n\nIf developing locally, add the following to `/etc/hosts`:\n\n```bash\n127.0.0.1 example.com\n# 127.0.0.1 localhost\n```\n\nWhere `example.com` is the value of `BASE_URL` in `.env`.\n\nRemember to revert / comment out the `127.0.0.1 example.com` line and reinstate `127.0.0.1 localhost` when done.\n\n### Both HTTP and HTTPS\n\nBuild and start the `nginx` container:\n\n```bash\ndocker compose up -d --build\n```\n\nNavigate to the `BASE_URL` in a browser:\n\n* `http://example.com`\n* `https://example.com`\n\n## TODO\n\n* [Issues](https://github.com/pythoninthegrass/hello_hugo/issues)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythoninthegrass%2Fhello_hugo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpythoninthegrass%2Fhello_hugo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythoninthegrass%2Fhello_hugo/lists"}