Hugo Dark Theme Website Generator https://after-dark.habd.as
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

post.md 4.7KB

{{/* Copyright © 2019 Josh Habdas jhabdas@protonmail.com

This file is part of After Dark.

After Dark is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

After Dark is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/. */ -}}

+++ title = “{{ replace .TranslationBaseName “-” “ ” | title }}” date = {{ .Date }} description = “This text was generated using the After Dark post archetype.” draft = true toc = false categories = [“hacking”] tags = [“after”, “dark”] images = [ “https://source.unsplash.com/collection/983219/1600x900” ] # overrides site-wide open graph image copyright owner = “{{ .Site.Params.author | default .Site.Title }}” date = “{{ now.Format “2006” }}” license = “cc-by-nc-sa-4.0” +++

Before continuing please create a post archetype. Archetypes are located within markdown files in the archetypes directory of your site:

flying-toasters
├── archetypes
│   ├── default.md
│   └── post.md
├── content

If post.md does not exist yet, copy it from the After Dark default:

$ cd flying-toasters
$ cp themes/after-dark/archetypes/post.md archetypes/

Make some changes to post.md then use hugo new to draft a new post:

$ vi archetypes/post.md # or vim, emacs, nano ...
$ hugo new post/totally-twisted.md

If hugo server is running with the --navigateToChanged flag your new post will appear automatically in JavaScript-enabled browsers. If you see an empty page you probably need to restart hugo server with the --buildDrafts flag.

Use archetypes to maintain consistency when creating content for Custom Layouts. Like custom layouts {{< external href=“https://gohugo.io/content-management/archetypes/” text=“Hugo Archetypes” />}} may contain templating logic.


{{< hackcss-alert type=“info” >}} Tip: This message appears below a {{< external href=“https://gohugo.io/content-management/summaries/#manual-summary-splitting” text=“Manual Summary Split” />}}. {{< /hackcss-alert >}}

The above tip uses a shortcode called Alert. In addition to a number of Shortcodes After Dark provides a number of other Features.

The Module System, for example, provides a module to display image animations with alpha transparency and something not possible using a GIF:

BPG animation example

If you do not see the above animation, you may install the Fractal Forest module yourself or reinstall After Dark using the Quick Install for instant setup.

Review the Online Help to learn about other useful features such as the Section Menus navigational aid, responsive Post Images, offline Fuzzy Search and more.

If online help isn’t running, go ahead and start it using the corresponding command from the following cheat sheet within your site directory:

# After Dark scripts
./themes/after-dark/bin/upgrade # check for updates and upgrade
./themes/after-dark/bin/help # start online help docs
./themes/after-dark/bin/install # run the quick installer

# Hugo commands
hugo # build site with default settings
hugo --minify # build with minified sources (hugo 0.47 and above)
hugo --config config.prod.toml # build with custom config
hugo --templateMetrics # generate template metrics
hugo new about.md # generate page content
hugo new post/coming-soon.md # generate new post content
hugo serve # serve locally with default settings
hugo serve --buildDrafts --navigateToChanged # serve with drafts for editing
hugo serve --buildExpired # serve locally showing expired content
hugo serve --disableLiveReload # serve locally w/live reload disabled
hugo list drafts # list draft content
hugo list expired # list expired content
hugo list future # list future content
hugo [serve] --debug # build or serve hugo with debug info
hugo [command] --help

Thank you for choosing After Dark.