{"id":17207360,"url":"https://github.com/abdus/hugo-theme-fiber","last_synced_at":"2025-04-13T22:13:26.614Z","repository":{"id":48481795,"uuid":"290098751","full_name":"abdus/hugo-theme-fiber","owner":"abdus","description":":books: Minimal Hugo theme for blog websites","archived":false,"fork":false,"pushed_at":"2021-07-23T12:23:07.000Z","size":243,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T22:13:22.803Z","etag":null,"topics":["clean","hugo","hugo-site","hugo-theme","minimal","minimalist","static-site","theme"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abdus.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}},"created_at":"2020-08-25T03:05:56.000Z","updated_at":"2024-10-03T10:33:32.000Z","dependencies_parsed_at":"2022-09-10T11:21:18.717Z","dependency_job_id":null,"html_url":"https://github.com/abdus/hugo-theme-fiber","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdus%2Fhugo-theme-fiber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdus%2Fhugo-theme-fiber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdus%2Fhugo-theme-fiber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdus%2Fhugo-theme-fiber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abdus","download_url":"https://codeload.github.com/abdus/hugo-theme-fiber/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248788912,"owners_count":21161728,"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":["clean","hugo","hugo-site","hugo-theme","minimal","minimalist","static-site","theme"],"created_at":"2024-10-15T02:45:18.994Z","updated_at":"2025-04-13T22:13:26.581Z","avatar_url":"https://github.com/abdus.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp  align=\"center\"\u003e\n\u003cimg src=\"https://i.imgur.com/WXrwYMu.png?cachebuster\" alt=\"hugo theme fiber\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg \n    src=\"https://img.shields.io/github/repo-size/abdus/hugo-theme-fiber\"\n    alt=\"github repo size\" \n  /\u003e\n  \u003cimg \n    alt=\"GitHub last commit\" \n    src=\"https://img.shields.io/github/last-commit/abdus/hugo-theme-fiber\"\n  /\u003e\n  \u003cimg \n    alt=\"GitHub\" \n    src=\"https://img.shields.io/github/license/abdus/hugo-theme-fiber\"\n  /\u003e\n  \u003cimg \n    alt=\"GitHub commits since latest release (by SemVer including pre-releases)\" \n    src=\"https://img.shields.io/github/commits-since/abdus/hugo-theme-fiber/latest?include_prereleases\"\n  /\u003e\n\u003c/p\u003e\n\nA Hugo theme for the minimalists. Fiber uses minimum JavaScript and CSS to\nso that you site could load faster! Also posses a clean UI which is great for\neyes!!\n\n## [Table of Contents](#table-of-contents)\n\n- [Installation](#installation)\n  - [Using Submodule](#using-submodule)\n  - [Directly downloading theme](#directly-downloading-theme)\n- [Features](#features)\n  - [SEO Ready](#seo-ready)\n  - [Shortcodes](#shortcodes)\n    - [ASCIINema](#asciinema)\n    - [Can I Use](#can-i-use)\n  - [Click to Copy Code](#click-to-copy-code)\n  - [Beautiful Notes](#beautiful-notes)\n- [Screenshots](#screenshots)\n- [Theme Set-up](#theme-set-up)\n  - [Listing content in Homepage](#listing-content-in-homepage)\n    - [List of blogs, notes etc](#list-of-blogs--notes-etc)\n    - [Listing custom content](#listing-custom-content)\n  - [Code Highlighting](#code-highlighting)\n  - [Menu Items](#menu-items)\n  - [Site Title](#site-title)\n- [Writing Content](#writing-content)\n  - [Writing Notes](#writing-notes)\n  - [Frontmatter](#frontmatter)\n\n## Installation\n\nThere are two ways this theme could be used with any Hugo-based sites.\n\n1. Using Git Submodules(recommended)\n2. Directly downloading theme to `\u003chugo-site-root\u003e/themes/`\n\n#### Using Submodule\n\n1. Create your site using `hugo new site SITE_NAME`\n2. `cd` to `SITE_NAME`\n3. Initialize a git repo: `git init`. This is needed because we have to add a git submodule.\n4. Add submodule by runing `git submodule add git@github.com:abdus/hugo-theme-fiber.git themes/hugo-theme-fiber`\n5. Now, start Hugo server locally using `hugo serve`\n\nIf there is an update in theme repository, you can pull them using `git submodule update --remote`\n\n#### Directly downloading theme\n\n\u003e Use this method if you cannot use Git for some reason.\n\n1. Download [this](https://github.com/abdus/hugo-theme-fiber) and extract its\n   content to `SITE_ROOT/themes/hugo-theme-fiber/`.\n2. Start hugo locally by executing `hugo serve` from terminal.\n\n## Features\n\n### SEO Ready\n\nThis theme is loaded with basic SEO as well as with minimal JSON-LD data\nfrom Schema.org\n\n### Shortcodes\n\nApart from out-of-the-box shortcodes, it does have a few other useful shortcodes\nwhich can be proven helpful at times.\n\n#### ASCIINema\n\nEmbed an AsciiNema Cast. Shortcode to use: `{{\u003c asciinema id=\"id of a public cast\" \u003e}}`\n\n#### Can I Use\n\nThis shortcode shows latest data from [caniuse.com](https://caniuse.com) website.\nUseful for web developers. Example:\n\n```html\n{{\u003c caniuse feature=\"abortcontroller\" periods=\"future_1,current,past_1,past_2\"\n\u003e}}\n```\n\n### Click to Copy Code\n\nVisitors of the website can copy content of any codeblock with just one click.\nThis will not break code indentations!\n\n### Beautiful Notes\n\nAnything you put inside `content/notes`, would get rough-annotations. This makes\nit easier to recognize important things from notes.\n\nRough Annotations are controlled using tags like `strong`, `em` and `strikethrough`.\nTo generate a new `notes` entry, first you must create directory `content/notes`.\nThen use `hugo new notes/file-name.md` to generate a Note. This file would\ncontain information about how to annotate things with above mentioned tags.\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://i.imgur.com/k0Pmjoh.png\" /\u003e\n\u003cimg src=\"https://i.imgur.com/lnSBRYD.png\" /\u003e\n\u003c/p\u003e\n\n## Theme Set-up\n\n### Listing content in Homepage\n\nHomepage can be configured in two different ways. You can either list your\nfavorite/most-important section from`content` directory.\n\nOr place custom content inside it.\n\nOr you can do both! Make sure to create a file `content/_index.md` that have\na property `title` inside fromtmatter. This `title` property is useful for\nSEO. Example:\n\n```markdown\n---\ntitle: \"Welcome to my Homepage\"\n---\n\n\u003c!-- content goes here --\u003e\n```\n\n#### List of blogs, notes etc\n\nIn order to create a listing of content in homepage, you need to set a\nvariable called `mainSections` in `config.toml` file. Example:\n\n```toml\n[params]\nmainSections = [\"posts\"]\n```\n\n#### Listing custom content\n\nTo list custom content, simply place them inside `content/_index.md` with\nappropriate frontmatter.\n\n### Code Highlighting\n\nBy default, Hugo would not use any classes. But this would not work for this\ntheme as some of the features depends on that.\n\nYou need to trun on classes for codeblocks. Here's how you'd do it:\n\n```toml\n# file: config.toml\n[markup]\n[markup.highlight]\ncodeFences = true\nnoClasses = false\n```\n\n### Menu Items\n\nBy default, there's only one menu item in top menu. To add more items in there,\none needs to define menu items inside `config.toml`. Following is an example\nfrom my [site's](https://abdus.xyz) `config.toml`:\n\n```toml\n[menu]\n\n  [[menu.main]]\n    identifier = \"me\"\n    name = \"Me\"\n    url = \"/me/\"\n    weight = 10\n\n\n  [[menu.main]]\n    identifier = \"keys\"\n    name = \"keys\"\n    url = \"/keys/\"\n    weight = 10\n\n  [[menu.main]]\n    identifier = \"categories\"\n    name = \"categories\"\n    url = \"/categories\"\n    weight = 10\n\n  [[menu.main]]\n    identifier = \"notes\"\n    name = \"notes\"\n    url = \"/notes/\"\n    weight = 10\n```\n\n### Site Title\n\nSite title is controlled by following params in `config.toml`:\n\n```toml\n[params]\n  title = \"abdus.xyz\"\n  mainSections = [\"posts\"]\n```\n\n## Writing Content\n\n### Writing Notes\n\n`Notes` is a special kind hard-coded in this theme. Contents of this kind would\nget rough-annotations(which makes it easier to manage notes).\n\nGenerate a notes page using command `hugo new notes/your-filename.md` to\nlearn how to use rough-annotations within notes' page.\n\nArchetype for kind Notes is included.\n\n### Frontmatter\n\nThis theme uses frontmatter to handle custom post description and meta image\nfor SEO. If it can't find `meta.image` and `meta.description`, it will fallback\nto `/images/default-meta-image.png` and `.Summary` respectively.\n\nUse these two fields in frontmatter like this:\n\n```markdown\n---\n...\n...\nmeta:\nimage: \"https://example.com/some-image.png\"\n  description: \"your custom desc\"\n...\n...\n---\n\n\u003c!-- content goes here --\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdus%2Fhugo-theme-fiber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdus%2Fhugo-theme-fiber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdus%2Fhugo-theme-fiber/lists"}