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.

106 lines
5.7 KiB

4 years ago
  1. <img
  2. alt="After Dark"
  3. src="https://git.habd.as/comfusion/after-dark/raw/branch/master/static/images/logo-dark.png"
  4. width="358">
  5. **Hugo Dark Theme Site Generator**
  6. <br>[Docs](https://after-dark.habd.as) • [Releases](https://git.habd.as/comfusion/after-dark/releases) • [Community](https://t.me/afterdarkhugo)
  7. ## After Dark
  8. [![Latest NPM version](https://img.shields.io/npm/v/after-dark.svg?style=flat-square)](https://www.npmjs.com/package/after-dark)
  9. [![Monthly downloads](https://img.shields.io/npm/dm/after-dark.svg?style=flat-square)](https://www.npmjs.com/package/after-dark)
  10. [![Minimum Hugo version](https://img.shields.io/badge/hugo->%3D%200.51-FF4088.svg?style=flat-square)](https://gohugo.io)
  11. [![IRC chat](https://img.shields.io/badge/irc-%23after--dark-32AFED.svg?style=flat-square&longCache=true)](https://after-dark.habd.as/#chat)
  12. [![AGPL licensed](https://img.shields.io/npm/l/after-dark.svg?style=flat-square&longCache=true)](https://git.habd.as/comfusion/after-dark/src/branch/master/COPYING)
  13. One command is all you need to start a new website:
  14. ```sh
  15. wget -qO - https://go.habd.as/after-dark | sh
  16. ```
  17. **After Dark** is an extensible, robust templating system for [Hugo](https://gohugo.io) written from the ground up for speed, privacy and security.
  18. ## Features
  19. Click a link below to learn more:
  20. - **[Developer Focused](https://after-dark.habd.as/#feature-workflow)**: Cross-platform, 1 dependency, single-codebase.
  21. - **[Incredibly Fast](https://after-dark.habd.as/#feature-speed)**: ~0.615s builds and decisecond page loads.
  22. - **[Privacy Aware](https://after-dark.habd.as/#feature-privacy)**: No cookies, no external requests, ephemeral hosting.
  23. - **[Securely Designed](https://after-dark.habd.as/#feature-security)**: Source-level integrity, content security and more.
  24. - **[Advanced Graphics](https://after-dark.habd.as/#feature-graphics)**: Silky-smooth post and homepage images.
  25. - **[Easily Customized](https://after-dark.habd.as/#feature-customize)**: Easily modify website look-and-feel.
  26. - **[Fuzzy Search](https://after-dark.habd.as/#feature-search)**: Offline, automatic and no third-parties.
  27. - **[Rewards System](https://after-dark.habd.as/#feature-rewards)**: Earn rewards for keeping your software up-to-date.
  28. - **[Batteries Included](https://after-dark.habd.as/#feature-extras)**: Integrate with Gitea, k8s, Traefik and Fathom.
  29. - **[Extended Builds](https://after-dark.habd.as/#feature-builds)**: Create high-performance Hugo builds with integrated Sass support.
  30. ## Screenshot
  31. [![Demo](https://after-dark.habd.as/images/screenshots/after-dark-v6.15.0-homepage-fs8.png)](https://after-dark.habd.as)
  32. ## Demo
  33. Visit the [official docs](https://after-dark.habd.as) for demo and documentation. For an example site see [habd.as](https://habd.as). Additional examples listed in the source repository Wiki.
  34. ## Getting Started
  35. [Install Hugo](https://gohugo.io/getting-started/installing) `0.51` or greater on your machine before getting started unless starting with [After Dark K3s](https://after-dark.habd.as/extra/after-dark-k3s) or creating an [Extended Build](https://after-dark.habd.as/#feature-builds).
  36. ### Installation
  37. For fastest installation use the provided [Quick Install](https://after-dark.habd.as/feature/quick-install/) script. Quick Install is ideal for first-time users and does not require use of git. Use it to automatically set-up, configure and run a sample After Dark website you may re-purpose as your own.
  38. By convention After Dark may be used with an existing Hugo site by git cloning to or adding as a submodule of the `themes` directory:
  39. ```sh
  40. flying-toasters
  41. ├── static
  42. └── themes
  43. └── after-dark # the clone or submodule
  44. ```
  45. See [Install a Single Theme](https://gohugo.io/themes/installing-and-using-themes/#install-a-single-theme) on the Hugo docs site for further instructions.
  46. After Dark releases are tagged in git and [packaged on NPM](https://www.npmjs.com/package/after-dark). Use the NPM package to integrate After Dark into existing workflows.
  47. ### Usage
  48. Review the [Online Help](https://after-dark.habd.as/feature/online-help/) to learn how to set-up and customize After Dark. Docs included with installation and may be served locally.
  49. ### Upgrading
  50. Run the [Upgrade Script](https://after-dark.habd.as/feature/upgrade-script/) to check for updates and upgrade automatically:
  51. ```sh
  52. ./themes/after-dark/bin/upgrade
  53. ```
  54. Upgrading replaces the file contents of the theme as a whole for security reasons. If you wish to modify the source please create a fork.
  55. ### Verifying
  56. If installed or upgraded via script you may use the [Release Validator](https://after-dark.habd.as/validate/) to verify you're running a PGP-signed and SHA-verified release. Integrity is checked at the source level and may be performed offline. See [Release Hashes](https://after-dark.habd.as/feature/release-hashes/) for more info.
  57. ## Credits
  58. Special thanks to エゴイスト for [hackcss](https://git.habd.as/jhabdas/hack), Dan Klammer for the [bytesize icons](https://git.habd.as/comfusion/bytesize-icons) and Vincent Prouillet for the [Zola port](https://www.getzola.org/themes/after-dark/).
  59. ## Rights
  60. Copyright (C) 2019 Josh Habdas <jhabdas@protonmail.com>
  61. After Dark is free software: you can redistribute it and/or modify
  62. it under the terms of the GNU Affero General Public License as published
  63. by the Free Software Foundation, either version 3 of the License, or
  64. (at your option) any later version.
  65. After Dark is distributed in the hope that it will be useful,
  66. but WITHOUT ANY WARRANTY; without even the implied warranty of
  67. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  68. GNU Affero General Public License for more details.
  69. You should have received a copy of the GNU Affero General Public License
  70. along with this program. If not, see <https://www.gnu.org/licenses/>.