+```
+
+```html
+
+
+```
+
+```html
+
+
+```
+
+Additional information and examples, including how to set-up and use LQIP (Low-Quality Image Placeholders), are available on the [lazysizes] repository on GitHub.
+
+### Related Content
+
+Promote more of your content to your site visitors. By offering your readers more content that's relevant to them you can increase your site's page views, the time spent on your site and reader loyalty.
+
+Related content surfaces content across sections by matching taxonomy tags. If After Dark finds related content it will automatically output a list of links to that content in reverse chronological order below the byline of your post content.
+
+By default After Dark will display up to 7 items by title along with their reading times. You can limit the number of items displayed by setting the following optional parameter in the `[params]` section of your `config.toml` file:
+
+```toml
+related_content_limit = 5
+```
+
+### Table Of Contents
+
+Help users locate and share information on your site. By providing a TOC, users will spend less time scrolling to location information in larger documents, and are more likely to deep to specific information on a page.
+
+To automatically generate a TOC for a post based on the [page outline](https://gsnedders.html5.org/outliner/), add the following to your post front matter:
+
+```toml
+toc = true
+```
+
+To hide the TOC set `toc = false`, or simply remove the setting from the post front matter.
+
+After Dark uses the HTML5 [`details`](http://devdocs.io/html/element/details) and [`summary`](http://devdocs.io/html/element/summary) elements to provide a TOC which does not require use of CSS or JavaScript to function.
+
+When a page is first loaded, the TOC will be collapsed so it does not clutter up the page. Once expanded, selecting an item in the TOC will smooth scroll to that section within the document, highlight the section header and updating the browser's location bar for deep linking and back-button support.
+
+### OpenGraph
+
+After Dark leverages OpenGraph tags using the *undocumented* [internal template](https://github.com/spf13/hugo/blob/95ad3ad2fa3e6f4514166b47b77f051d280c16e9/tpl/template_embedded.go#L161-L204) to achieve rich sharing cards for Facebook and other social networks, as shown here:
+
+
+
+Specify `author` in `config.toml` and, optionally, override it from your post front matter:
+
+```toml
+title = "Become a Digital Nomad in Bali: The Lost Guide"
+description = "Everything you need to know to become a Digital Nomad in Bali."
+author = "After Dark"
+date = "2017-02-02T11:57:24+08:00"
+publishdate = "2017-01-28T02:31:22+08:00"
+images = [
+ "https://source.unsplash.com/-09QE4q0ezw/2000x1322"
+]
+```
+
+To configure a site-wide OpenGraph images and fallbacks for posts not specifying their own, add the following to your site parameters in `config.toml` in the `[params]` section:
+
+```toml
+images = [
+ "https://source.unsplash.com/-09QE4q0ezw/2000x1322" # Default OpenGraph image for site
+]
+```
+
+Test how things are looking during development using a combination of the [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/) and [ngrok](https://ngrok.com/).
+
+### SEO and UX
+
+After Dark is built with SEO in mind. Aside from OpenGraph, Schema Structured Data and SEO meta is applied to give robots what they want, automatically, without any user configuration necessary. This helps ensure your After Dark site will rank well in Search Engine Results Pages (SERPs) and prevent crawlers from indexing undesirable content.
+
+Fine-tune your SEO settings using the following available options.
+
+### Webmaster Verification
+
+Verify your site with several webmaster tools including Google, Bing, Alexa and Yandex. To allow verification of your site with any or all of these providers simply add the following to your `config.toml` and fill in their respective values:
+
+```toml
+[params.seo.webmaster_verifications]
+ google = "" # Optional, Google verification code
+ bing = "" # Optional, Bing verification code
+ alexa = "" # Optional, Alexa verification code
+ yandex = "" # Optional, Yandex verification code
+```
+
+**Note:** Claiming your site with Alexa was [retired in May 2016](https://support.alexa.com/hc/en-us/articles/219135887-Claiming-has-been-retired-May-2016). However, Alexa verification has been added as a convenience for existing sites migrating to After Dark.
+
+### Meta Descriptions
+
+Well-crafted page titles help catch the human eye on search results pages. And meta descriptions provide a summary of the content and why its relevant for the reader, driving click-throughs.
+
+To add a custom meta description to your pages and posts add `description` to the front matter:
+
+```toml
+description = "Everything you need to know to become a Digital Nomad in Bali."
+```
+
+In addition to appearing in search engines, meta descriptions also appear on individual pages and in content summaries in After Dark, adding transparency to how your page will appear in search.
+
+If no custom description is provided After Dark will fallback to the description provided in `config.toml`. Learn more on [how to craft your meta descriptions](https://moz.com/learn/seo/meta-description).
+
+### Modification Dating
+
+Help user agents know when posts were last modified. To do so add `publishdate` to your page front matter and update `date` anytime you make an update to a post.
+
+Updates will be made visible to readers by surfacing content higher in your page and post listings, and using using visible callouts on content summaries. For robots, making this change will automatically update Schema Structured Data and Web feeds, as well as the `lastmod` setting your `sitemap.xml` file.
+
+You can be specific and use a datetime (with timezone offset) like:
+
+```
+date = "2017-02-02T01:20:56-06:00"
+publishdate = "2016-11-21T10:32:33+08:00"
+```
+
+Or less specific and use just the dates:
+
+```
+date = "2017-02-02"
+publishdate = "2016-11-21"
+```
+
+Review the W3C website for more [information on dates and times](https://www.w3.org/TR/html51/infrastructure.html#dates-and-times) for the Web infrastructure.
+
+### Link Types
+
+For related content split across multiple pages in a sequence After Dark supports use of `prev` and `next` settings in your front matter.
+
+Learn more about [link types](http://devdocs.io/html/link_types).
+
+### Index Blocking
+
+Just because a page appears in your `sitemap.xml` does not mean you want it to appear in a SERP. Examples of pages which will appear in your `sitemap.xml` that you typically do not want indexed by crawlers include error pages, search pages, legal pages, and pages that simply list summaries of other pages.
+
+Though it's possible to block search indexing from a `robots.txt` file, After Dark makes it possible to block page indexing using Hugo configuration as well. By default the following page types will be blocked:
+
+- Section Pages (e.g. Post listings)
+- Taxonomy Pages (e.g. Category and Tag listings)
+- Taxonomy Terms Pages (e.g. Pages listing taxonomies)
+
+To customize default blocking configure the `noindex_kinds` setting in the `[params]` section of your `config.toml`. For example, if you want to enable crawling for sections appearing in [Section Menu](#adding-a-section-menu) add the following to your configuration file:
+
+```
+[params]
+ noindex_kinds = [
+ "taxonomy",
+ "taxonomyTerm"
+ ]
+```
+
+To block individual pages from being indexed add `nofollow` to your page's front matter and set the value to `true`, like:
+
+```toml
+noindex = true
+```
+
+And, finally, if you're using Hugo `v0.18` or better, you can also add an `_index.md` file with the `noindex` front matter to control indexing for specific section list layouts:
+
+```shell
+├── content
+│ ├── modules
+│ │ ├── starry-night.md
+│ │ └── flying-toilets.md
+│ └── news
+│ ├── _index.md
+│ └── return-flying-toasters.md
+```
+
+To learn more about how crawlers use this feature read [block search indexing with meta tags](https://support.google.com/webmasters/answer/93710).
+
+### Markdown Output
+
+Gain more control over markdown conversion to HTML. By modifying the markdown processor settings you can take advantage of [Blackfriday](https://github.com/russross/blackfriday) features not enabled by default.
+
+To customize conversion output add a `[blackfriday]` section to your site's `config.toml` file like so:
+
+```toml
+[blackfriday]
+ hrefTargetBlank = true
+ fractions = false
+```
+
+Overrides to theme markdown processing defaults are available from page front matter as well, giving you control on a page-by-page basis.
+
+See the Hugo docs for additional [configuration options](http://gohugo.io/overview/configuration/#configure-blackfriday-rendering).
+
+### Shortcodes
+
+Keep your content DRY and improve thematic consistency across your site. To help achieve this, Hugo provides [Shortcodes](https://gohugo.io/extras/shortcodes).
+
+Shortcodes are very powerful, and can be used to achieve functionality not otherwise available in the markdown processor. Hugo provides a number of [built-in shortcodes](https://gohugo.io/extras/shortcodes#built-in-shortcodes) you can use on your site. And After Dark provides some as well.
+
+Here's the `blockquote` shortcode provided by After Dark:
+
+```html
++ {{ .Title }} +
+ {{ if eq .Type "post" }} +{{ partial "post/meta" . }}
+ {{ end }} +{{ .Description }}+ {{ end }} +
+ {{ .Summary }}
+
+ {{ if .Truncated }}
+
+ {{ end }}
+
+ 
+ 
++ A simple, yet highly configurable responsive dark theme for the Hugo static site generator. +
+ +
+
+
+
+
+
+
| Feature | +Summary | +
|---|---|
| Deceptive Simplicity | +After Dark is a Hugo theme, making it a suitable starting point for novice and advanced developers alike. It advances using the "Code for today, not for tomorrow" philosophy of XP, and includes only what's necessary to create and run your site – nothing more. | +
| Semantic Versioning | +Predictable changes enable theme users stay up-to-date with what's happening. After Dark uses Semantic Versioning and maintains a CHANGELOG for easy consumption. | +
| Inclusive Design | +Optimized for mobile, tablet, desktop and terminal browsers. | +
| Performance Optimized | +Page content and styles load in a single request on all pages. External resources, if present, are loaded asynchronously, and only when necessary. This keeps pages zippy, and affords ~1 second page loads over 2G when hosted using a CDN. | +
| Vertical Scaling | +After Dark is capable of generating ~1000 pages per second thanks to Hugo, and is likely to become faster over time. | +
| Search Awareness | +Using Schema Structured Data and meta tags, After Dark gives crawlers rich data about the site structure, page and page author. No configuration required. | +
| Social Awareness | +After Dark provides automatic and configurable OpenGraph support, making social shares pop like 37 pieces of flair. | +
| Personalization | +Not completely satisfied with the default look-and-feel? Customize the theme to your liking using one of the available theme variants provided by hack.css. | +
| Section Menu | +Add and customize your site's global navigation. After Dark uses Hugo's Section Menu for "the Lazy Blogger", making navigation easy to create and predictable to use. Don't want navigation? Simply disable it from your site configuration. | +
| Intelligent Lazyloading | +Lazyload your images, iFrames and script embeds. After Dark uses the lazysizes library, a zero-configuration JavaScript library with support for LQIP and responsive images. | +
| Related Content | +Promote more of your content to your site visitors. By offering your readers more content that's relevant to them you can increase your site's page views, the time spent on your site and reader loyalty. | +
| Table Of Contents | +Help users locate and share information on your site. By providing a TOC, users will spend less time scrolling to locate information in larger documents, and are more likely to deep link to specific information on a page. | +
| Analytics | +Understand and action on user behavior by enabling Google Analytics. After Dark uses the async tracking snippet to boost performance and allow script preloading. | +
| User Generated Content | +Improve search rankings and provide interactivity to users with UGC. Enable Disqus commenting to get started. | +
| Reading Time | +Set user expectations up-front. After Dark provides estimated reading time for each post near the top of the page. This feature is automatic and assumes a reading speed of 200-250 words per minute. | +
| Modification Dating | +Surface recently updated content to users and crawlers, allowing them to understand when a post or page was was last modified. Recently updated posts will be flagged as modified, and visually lifted upwards in chronological listings. | +
| Syntax Highlighting | +Share code snippets with style. After Dark provides opt-in syntax highlighting with support for line numbers and highlighted lines. | +
| Taxonomy Pages | +Help users discover taxonomic content. After Dark automatically generates taxonomy and taxonomy terms pages, and links to them in post bylines. | +
| Post Bylines | +Rich post bylines include optional author name, word count, links to taxonomy pages and metadata for search engines. | +
| Pagination | +Pagination can be hard. After Dark makes it easy with simple list pagination with page indication. | +
| Animated Error Page | +Decrease bounce rate when URL errors occur. After Dark provides an engaging 404 page with animated background. | +
| Accessibility | +After Dark uses semantic HTML5 markup to provide a better experience for aural readers and facilitates navigation via keyboard only. | +
+ {{ .Inner }} + {{ with .Get "citelink" }} + {{ $.Get "cite" }} + {{ else }} + {{ .Get "cite" }} + {{ end }} ++``` + +Use it in your markdown files like: + +```html +{{< blockquote cite="Bitly" citelink="https://bitly.is/2mkxskj" >}} +
When you create your own Branded Short Domain, you can expect to see up to a 34% increase in CTR when compared to standard bit.ly links.
+{{< /blockquote >}} +``` + +Additional theme-provided shortcodes at your disposal: + +- `figure` - Similar to the Hugo built-in, but with [Intelligent Lazyloading](#intelligent-lazyloading), an adjusted caption title and smaller caption text. + +To create your own custom shortcodes add a `layouts/shortcodes` directory to your site, place your shortcodes within and start using them in your markdown content. + +Reference the Hugo docs for [shortcode usage instructions](https://gohugo.io/extras/shortcodes#using-a-shortcode). + +### Syntax Highlighting + +Provide a richer experience when sharing code snippets on your site. After Dark provides support for code highlighting using the lovely [One Dark](https://github.com/atom/one-dark-syntax) or [One Light](https://github.com/atom/one-light-syntax) syntax themes used in [Atom](https://github.com/atom/atom). + +**Why not use Highlight.js?** Because it's slow, doesn't support line numbers or highlighting of individual lines. In addition, JS-based solutions force browsers to do the same work over and over when that work can be done once during site generation. + +To set-up syntax highlighting for your After Dark site: + +- Follow Hugo's [Pygments installation](https://gohugo.io/extras/highlighting/#pygments) instructions. +- Open the `themes/after-dark` folder and run `npm i` (assumes NPM installed) +- Then open `./node_modules/atom-one-pygments` and `npm i` +- Once dependencies are installed, issue `npm run build` to generate the stylesheets to the `./dist` directory + +Then choose either `./dist/light.css` or `dark.css` depending on your [Theme Variant](#theme-variants), and copy the contents of the file into your [Custom CSS](#custom-css) file. + +Once configured, syntax highlighting can be achieved using the Hugo built-in [`highlight` shortcode](https://gohugo.io/extras/shortcodes#highlight). Reference Hugo's Syntax Highlighting docs for [additional usage instructions](https://gohugo.io/extras/highlighting/#usage). + +### Custom CSS + +To add your own theme css or override existing CSS without having to change theme files do the following: + +1. Create a `critical-custom.css.html` in your site's `layouts/partials directory`. +1. Add your customizations inside a `style` element. + +Example customization file: + +```html + +``` + +Your customizations will automatically be added to generated pages, inline in the document `HEAD`. Thanks to [@rsommerard](https://github.com/rsommerard) for making the suggestion. + +### Theme Variants + +[`hack.css`](http://hackcss.com/) provides a few variants you may wish to use instead of the After Dark defaults. To download them do an `npm i` from `/themes/after-dark/` (assumes NPM installed). + +Once downloaded, open `node_modules/hack/dist` directory and replace the CSS contents of `critical-vendor.css.html` with those you wish to use, updating the `theme_variant` setting in the site configuration like: + + theme_variant = "standard dark-grey" + +**Why not use external CSS files?** After Dark is optimized for speed, and, as a result, limits the number of HTTP requests whenever possible. This just so happens to be of those occasions. + +Once the vendor file is updated, open your favorite dev tools and test the changes by previewing your site on mobile, tablet and desktop at different display resolutions and orientations, making any tweaks necessary to `critical-theme.css.html`. + +And, finally, adjust your [Customized CSS](#custom-css), 404 page and `/meta/theme-color` as necessary. + +## Contributing + +If you've spotted a bug or would like to make an enhancement suggestion, please [open an issue on GitHub](https://github.com/comfusion/after-dark/issues). Build something awesome with After Dark? [Add it to the wiki](https://github.com/comfusion/after-dark/wiki) for others to see. For general questions or support, please feel free to reach out to me directly at: [https://habd.as/contact](https://habd.as/contact). Thanks! + +## License + +[ISC](https://github.com/comfusion/after-dark/blob/master/LICENSE) + +[lazysizes]: https://github.com/aFarkas/lazysizes diff --git a/themes/hugo-after-dark/archetypes/default.md b/themes/hugo-after-dark/archetypes/default.md new file mode 100644 index 0000000..bb378b3 --- /dev/null +++ b/themes/hugo-after-dark/archetypes/default.md @@ -0,0 +1,3 @@ ++++ +description = "" ++++ diff --git a/themes/hugo-after-dark/archetypes/post.md b/themes/hugo-after-dark/archetypes/post.md new file mode 100644 index 0000000..8a4b38e --- /dev/null +++ b/themes/hugo-after-dark/archetypes/post.md @@ -0,0 +1,6 @@ ++++ +description = "" +draft = true +categories = [""] +tags = ["", ""] ++++ diff --git a/themes/hugo-after-dark/images/design/dark_code_editor_window.sketch b/themes/hugo-after-dark/images/design/dark_code_editor_window.sketch new file mode 100755 index 0000000..52c74b3 Binary files /dev/null and b/themes/hugo-after-dark/images/design/dark_code_editor_window.sketch differ diff --git a/themes/hugo-after-dark/images/design/minimalMacbook.sketch b/themes/hugo-after-dark/images/design/minimalMacbook.sketch new file mode 100644 index 0000000..ad40dff Binary files /dev/null and b/themes/hugo-after-dark/images/design/minimalMacbook.sketch differ diff --git a/themes/hugo-after-dark/images/minimal-mac.png b/themes/hugo-after-dark/images/minimal-mac.png new file mode 100644 index 0000000..89b69d8 Binary files /dev/null and b/themes/hugo-after-dark/images/minimal-mac.png differ diff --git a/themes/hugo-after-dark/images/screenshot.png b/themes/hugo-after-dark/images/screenshot.png new file mode 100644 index 0000000..4db063e Binary files /dev/null and b/themes/hugo-after-dark/images/screenshot.png differ diff --git a/themes/hugo-after-dark/images/terminal.png b/themes/hugo-after-dark/images/terminal.png new file mode 100644 index 0000000..557a5c2 Binary files /dev/null and b/themes/hugo-after-dark/images/terminal.png differ diff --git a/themes/hugo-after-dark/images/tn.png b/themes/hugo-after-dark/images/tn.png new file mode 100644 index 0000000..6db6a8a Binary files /dev/null and b/themes/hugo-after-dark/images/tn.png differ diff --git a/themes/hugo-after-dark/layouts/404.html b/themes/hugo-after-dark/layouts/404.html new file mode 100644 index 0000000..d110b21 --- /dev/null +++ b/themes/hugo-after-dark/layouts/404.html @@ -0,0 +1,100 @@ + + {{ .Hugo.Generator }} + + + +{{ partial "post/meta" . }}
+ {{ end }} +{{ .Description }}+ {{ end }} +
+ Published + {{ if ne .Site.Params.hide_author true }} + {{ with .Params.author }} + by {{ index . }} + {{ else }} + by {{ .Site.Params.author }} + {{ end }} + {{ end }} + + {{ with .Params.categories }} + in {{ delimit (apply (apply (sort .) "partial" "post/category-link" ".") "chomp" ".") ", " " and " }} + {{ end }} + {{ with .Params.tags }} + and tagged {{ delimit (apply (apply (sort .) "partial" "post/tag-link" ".") "chomp" ".") ", " " and " }} + {{ end }} + using {{ .WordCount }} words. +
diff --git a/themes/hugo-after-dark/layouts/partials/post/category-link.html b/themes/hugo-after-dark/layouts/partials/post/category-link.html new file mode 100644 index 0000000..6bee96b --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/post/category-link.html @@ -0,0 +1 @@ +{{ . }} diff --git a/themes/hugo-after-dark/layouts/partials/post/meta.html b/themes/hugo-after-dark/layouts/partials/post/meta.html new file mode 100644 index 0000000..d26bb9e --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/post/meta.html @@ -0,0 +1,15 @@ + +{{ .ReadingTime }} minute read + +{{ if .PublishDate.IsZero }} + Published: +{{ else if lt .PublishDate .Lastmod }} + Modified: +{{ else }} + Published: +{{ end }} diff --git a/themes/hugo-after-dark/layouts/partials/post/related-content.html b/themes/hugo-after-dark/layouts/partials/post/related-content.html new file mode 100644 index 0000000..7083fd5 --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/post/related-content.html @@ -0,0 +1,15 @@ +{{ range first 1 (where (where .Site.Pages ".Params.tags" "intersect" .Params.tags) "Permalink" "!=" .Permalink) }} + {{ $.Scratch.Set "has_related" true }} +{{ end }} + +{{ if $.Scratch.Get "has_related" }} + +{{ end }} diff --git a/themes/hugo-after-dark/layouts/partials/post/tag-link.html b/themes/hugo-after-dark/layouts/partials/post/tag-link.html new file mode 100644 index 0000000..8c03421 --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/post/tag-link.html @@ -0,0 +1 @@ +{{ . }} diff --git a/themes/hugo-after-dark/layouts/partials/powered-by.html b/themes/hugo-after-dark/layouts/partials/powered-by.html new file mode 100644 index 0000000..1c58584 --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/powered-by.html @@ -0,0 +1,8 @@ +{{ if ne .Site.Params.powered_by false }} ++ This page was generated using + After Dark + for + Hugo. +
+{{ end }} diff --git a/themes/hugo-after-dark/layouts/partials/site-verification.html b/themes/hugo-after-dark/layouts/partials/site-verification.html new file mode 100644 index 0000000..c4d8b05 --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/site-verification.html @@ -0,0 +1,12 @@ +{{ if .Site.Params.seo.webmaster_verifications.google }} + +{{ end }} +{{ if .Site.Params.seo.webmaster_verifications.bing }} + +{{ end }} +{{ if .Site.Params.seo.webmaster_verifications.alexa }} + +{{ end }} +{{ if .Site.Params.seo.webmaster_verifications.yandex }} + +{{ end }} diff --git a/themes/hugo-after-dark/layouts/partials/toc-maybe.html b/themes/hugo-after-dark/layouts/partials/toc-maybe.html new file mode 100644 index 0000000..cf03efc --- /dev/null +++ b/themes/hugo-after-dark/layouts/partials/toc-maybe.html @@ -0,0 +1,20 @@ +{{ if and (isset .Params "toc") .Params.toc }} +{{ partial "post/meta" . }}
+{{ .Description }}+ {{ end }} + {{ partial "toc-maybe" . }} +
+ {{ .Inner }} + {{ with .Get "citelink" }} + {{ $.Get "cite" }} + {{ else }} + {{ .Get "cite" }} + {{ end }} +diff --git a/themes/hugo-after-dark/layouts/shortcodes/figure.html b/themes/hugo-after-dark/layouts/shortcodes/figure.html new file mode 100644 index 0000000..620acec --- /dev/null +++ b/themes/hugo-after-dark/layouts/shortcodes/figure.html @@ -0,0 +1,35 @@ + +