{"id":34656817,"url":"https://github.com/nilp0inter/nanoblogger-hugo-theme","last_synced_at":"2026-06-01T07:04:11.204Z","repository":{"id":329659430,"uuid":"1120329556","full_name":"nilp0inter/nanoblogger-hugo-theme","owner":"nilp0inter","description":"A faithful recreation of the classic NanoBlogger static site generator theme for Hugo","archived":false,"fork":false,"pushed_at":"2025-12-21T01:09:26.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-22T22:44:29.583Z","etag":null,"topics":["blog","classic","hugo","hugo-theme","minimal","nanoblogger","retro","static-site","theme"],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nilp0inter.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-21T01:07:30.000Z","updated_at":"2025-12-21T01:09:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nilp0inter/nanoblogger-hugo-theme","commit_stats":null,"previous_names":["nilp0inter/nanoblogger-hugo-theme"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nilp0inter/nanoblogger-hugo-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilp0inter%2Fnanoblogger-hugo-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilp0inter%2Fnanoblogger-hugo-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilp0inter%2Fnanoblogger-hugo-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilp0inter%2Fnanoblogger-hugo-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nilp0inter","download_url":"https://codeload.github.com/nilp0inter/nanoblogger-hugo-theme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilp0inter%2Fnanoblogger-hugo-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33763681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["blog","classic","hugo","hugo-theme","minimal","nanoblogger","retro","static-site","theme"],"created_at":"2025-12-24T18:20:05.065Z","updated_at":"2026-06-01T07:04:11.185Z","avatar_url":"https://github.com/nilp0inter.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NanoBlogger Hugo Theme\n\nA Hugo theme inspired by the classic NanoBlogger static site generator. This theme replicates the clean, minimalist two-column design of the original NanoBlogger.\n\n## Features\n\n- Clean, minimalist two-column layout\n- Sidebar with:\n  - **Calendar widget** showing current month with post links\n  - Recent entries\n  - Categories\n  - Archives by year\n  - RSS feed link\n  - Custom links\n  - Contact information\n- Responsive typography using classic web-safe fonts (Palatino, Georgia, Verdana)\n- Support for categories/tags\n- Archive pages\n- RSS feed support\n- Pagination on home page\n\n## Installation\n\n### As a Hugo Module (recommended)\n\n1. Initialize your Hugo site as a module:\n\n```bash\nhugo mod init github.com/nilp0inter/yoursite\n```\n\n2. Add the theme to your `config.toml`:\n\n```toml\n[module]\n  [[module.imports]]\n    path = \"github.com/nilp0inter/nanoblogger-hugo-theme\"\n```\n\n### As a Git Submodule\n\n```bash\ncd your-hugo-site\ngit submodule add https://github.com/nilp0inter/nanoblogger-hugo-theme.git themes/nanoblogger-hugo-theme\n```\n\nThen add to your `config.toml`:\n\n```toml\ntheme = \"nanoblogger-hugo-theme\"\n```\n\n### Manual Installation\n\nDownload the theme and place it in your `themes/` directory, then reference it in your config.\n\n## Configuration\n\nHere's a complete example `config.toml`:\n\n```toml\nbaseURL = \"https://example.org/\"\nlanguageCode = \"en-us\"\ntitle = \"My Blog\"\ntheme = \"nanoblogger-hugo-theme\"\n\n[params]\n  description = \"A simple blog powered by Hugo\"\n  author = \"Your Name\"\n  intro = \"\"\"\n**Introduction**\n\nThis is my blog where I write about various topics.\n\"\"\"\n  footer_text = \"powered by [Hugo](https://gohugo.io)\"\n  contact = \"you@example.com\"\n  \n# Sidebar links (optional)\n[[params.sidebar_links]]\n  name = \"Main\"\n  url = \"/\"\n\n[[params.sidebar_links]]\n  name = \"About\"\n  url = \"/about/\"\n\n# Configure main sections (for recent entries)\n[params]\n  mainSections = [\"post\"]\n\n# Enable RSS\n[outputs]\n  home = [\"HTML\", \"RSS\"]\n  section = [\"HTML\", \"RSS\"]\n\n# Configure permalinks to match NanoBlogger style\n[permalinks]\n  post = \"/archives/:year/:month/:day/:slug/\"\n```\n\n## Content\n\n### Creating a new post\n\n```bash\nhugo new post/my-first-post.md\n```\n\n### Post front matter\n\n```yaml\n---\ntitle: \"My First Post\"\ndate: 2024-01-15T10:30:00Z\ncategories: [\"blog\", \"tech\"]\ndraft: false\n---\n\nYour content here...\n```\n\n## Directory Structure\n\n```\n.\n├── archetypes/\n├── layouts/\n│   ├── _default/\n│   │   ├── baseof.html\n│   │   ├── list.html\n│   │   └── single.html\n│   ├── partials/\n│   │   └── sidebar.html\n│   └── index.html\n├── static/\n│   └── css/\n│       └── nb_clean.css\n└── theme.toml\n```\n\n## Customization\n\n### Calendar Widget\n\nThe calendar widget is enabled by default and shows the current month with days that have posts linked. To disable it, add this to your `config.toml`:\n\n```toml\n[params]\n  disable_calendar = true\n```\n\nThe calendar:\n- Displays the current month automatically\n- Links days that have published posts\n- Uses the same styling as the original NanoBlogger calendar\n- Updates dynamically when you add new posts\n\n### Styling\n\nThe main stylesheet is located at `static/css/nb_clean.css`. You can override styles by creating your own `assets/css/custom.css` in your site directory and linking it in the config or by copying and modifying the theme's CSS file.\n\n### Colors\n\nThe default color scheme uses:\n- Text: `#333` (dark gray)\n- Links: `#003366` (dark blue)\n- Hover: `#999999` (gray)\n- Accents: `#666600` (olive)\n- Borders: `#999` (gray)\n\n### Fonts\n\nThe theme uses a classic web font stack:\n- Headings: Palatino, Georgia, Verdana, Arial, sans-serif\n- Body: Verdana, Arial, sans-serif\n\n## Credits\n\nThis theme is inspired by the original NanoBlogger static site generator created by n1xt3r. NanoBlogger was a bash-based weblog engine that generated static HTML content using common UNIX tools.\n\n## Credits and Attribution\n\nThis theme is a faithful recreation of the classic **NanoBlogger** static site generator theme, adapted for Hugo.\n\n**NanoBlogger** was created by n1xt3r and released under the GNU General Public License. The original project can be found at [https://nanoblogger.sourceforge.net/](https://nanoblogger.sourceforge.net/)\n\nThis Hugo theme recreates the NanoBlogger aesthetic and functionality while leveraging Hugo's modern features. If you use this theme, please include attribution to both:\n- **Hugo** - The static site generator: [https://gohugo.io](https://gohugo.io)\n- **NanoBlogger** - The original inspiration: [https://nanoblogger.sourceforge.net/](https://nanoblogger.sourceforge.net/)\n\nExample footer text in your `config.toml`:\n```toml\n[params]\n  footer_text = \"powered by [Hugo](https://gohugo.io) and [NanoBlogger](https://nanoblogger.sourceforge.net/) theme\"\n```\n\n## License\n\nMIT License - feel free to use and modify as needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilp0inter%2Fnanoblogger-hugo-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnilp0inter%2Fnanoblogger-hugo-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilp0inter%2Fnanoblogger-hugo-theme/lists"}