Browse Source

docs(feature): finish remaining todo items

close #87
Josh Habdas 3 months ago
parent
commit
03df2ebf79
Signed by: Josh Habdas <jhabdas@protonmail.com> GPG Key ID: B148B31154C75A74
35 changed files with 239 additions and 74 deletions
  1. 13
    6
      README.md
  2. 18
    1
      docs/assets/css/conditional/layout/landing.css
  3. 3
    0
      docs/assets/css/custom.css
  4. 1
    1
      docs/config/_default/config.toml
  5. 29
    21
      docs/content/_index.md
  6. 2
    0
      docs/content/feature/_index.id.md
  7. 1
    1
      docs/content/feature/_index.md
  8. 12
    6
      docs/content/feature/code-highlighter.id.md
  9. 11
    7
      docs/content/feature/code-highlighter.md
  10. 2
    2
      docs/content/feature/ephemeral-hosting.id.md
  11. 2
    2
      docs/content/feature/ephemeral-hosting.md
  12. 37
    0
      docs/content/feature/extended-builds.id.md
  13. 37
    0
      docs/content/feature/extended-builds.md
  14. 1
    1
      docs/content/feature/keywords-meta.id.md
  15. 1
    1
      docs/content/feature/keywords-meta.md
  16. 2
    2
      docs/content/feature/last-modified.md
  17. 1
    1
      docs/content/feature/link-typing.id.md
  18. 1
    1
      docs/content/feature/link-typing.md
  19. 2
    2
      docs/content/feature/quick-install.id.md
  20. 2
    2
      docs/content/feature/quick-install.md
  21. 8
    1
      docs/content/feature/skin-styles.id.md
  22. 8
    1
      docs/content/feature/skin-styles.md
  23. 1
    1
      docs/content/feature/social-meta.md
  24. 1
    1
      docs/content/feature/structured-data.id.md
  25. 1
    1
      docs/content/feature/structured-data.md
  26. 12
    1
      docs/content/feature/svg-favicon.id.md
  27. 14
    3
      docs/content/feature/svg-favicon.md
  28. 1
    0
      docs/content/feature/webmaster-tools.id.md
  29. 1
    0
      docs/content/feature/webmaster-tools.md
  30. 4
    1
      docs/content/feature/work-offline.id.md
  31. 4
    1
      docs/content/feature/work-offline.md
  32. 2
    2
      docs/content/module/toxic-swamp.md
  33. 2
    2
      docs/content/shortcode/text-input.md
  34. 1
    1
      docs/layouts/index.html
  35. 1
    1
      docs/layouts/partials/head/favicon.html

+ 13
- 6
README.md View File

@@ -22,15 +22,16 @@ wget -qO - https://go.habd.as/after-dark | sh
22 22
 
23 23
 ## Features
24 24
 
25
-- **[Streamlined Workflow](https://after-dark.habd.as/#feature-workflow)**: Cross-platform, 1 dependency, single-codebase.
25
+- **[Developer Focused](https://after-dark.habd.as/#feature-workflow)**: Cross-platform, 1 dependency, single-codebase.
26 26
 - **[Incredibly Fast](https://after-dark.habd.as/#feature-speed)**: ~0.615s builds and decisecond page loads.
27
-- **[Privacy Focused](https://after-dark.habd.as/#feature-privacy)**: No cookies, no external requests, ephemeral hosting.
27
+- **[Privacy Aware](https://after-dark.habd.as/#feature-privacy)**: No cookies, no external requests, ephemeral hosting.
28 28
 - **[Advanced Graphics](https://after-dark.habd.as/#feature-graphics)**: Silky-smooth post and homepage images.
29 29
 - **[Easily Customized](https://after-dark.habd.as/#feature-customize)**: Easily modify website look-and-feel.
30 30
 - **[Fuzzy Search](https://after-dark.habd.as/#feature-search)**: Offline, automatic and no third-parties.
31 31
 - **[Rewards System](https://after-dark.habd.as/#feature-rewards)**: Earn rewards for keeping your software up-to-date.
32 32
 - **[Securely Designed](https://after-dark.habd.as/#feature-security)**: Source-level integrity, content security and more.
33 33
 - **[Batteries Included](https://after-dark.habd.as/#feature-extras)**: Integrate with Gitea, k8s, Traefik and Fathom.
34
+- **[Extended Builds](https://after-dark.habd.as/#feature-builds)**: Create high-performance Hugo builds with integrated Sass support.
34 35
 
35 36
 ## Demo
36 37
 
@@ -92,6 +93,12 @@ Please [Install Hugo](https://gohugo.io/getting-started/installing) `0.44` or gr
92 93
 
93 94
 ### Installation
94 95
 
96
+One command is all you need to start a new website:
97
+
98
+```sh
99
+wget -qO - https://go.habd.as/after-dark | sh
100
+```
101
+
95 102
 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.
96 103
 
97 104
 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:
@@ -107,6 +114,10 @@ See [Install a Single Theme](https://gohugo.io/themes/installing-and-using-theme
107 114
 
108 115
 After Dark also ships [as an NPM module](https://www.npmjs.com/package/after-dark) as a convenience for users. Use it to integrate After Dark into an existing publishing workflow.
109 116
 
117
+### Usage
118
+
119
+Use [Online Help](https://after-dark.habd.as/feature/online-help/) to learn how to set-up and use After Dark. Help docs may be served locally and do not require an Internet connection to function.
120
+
110 121
 ### Upgrading
111 122
 
112 123
 Run the [Upgrade Script](https://after-dark.habd.as/feature/upgrade-script/) to check for updates and upgrade automatically:
@@ -121,10 +132,6 @@ Upgrading replaces the file contents of the theme as a whole.
121 132
 
122 133
 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.
123 134
 
124
-### Usage
125
-
126
-Use [Online Help](https://after-dark.habd.as/feature/online-help/) to learn how to set-up and use After Dark. Help docs may be served locally and do not require an Internet connection to function.
127
-
128 135
 ## Credits
129 136
 
130 137
 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/).

+ 18
- 1
docs/assets/css/conditional/layout/landing.css View File

@@ -165,6 +165,23 @@ nav[itemtype*="SiteNavigationElement"]:focus-within {
165 165
 .hack footer section.cta a small {
166 166
   display: block;
167 167
 }
168
-.dark table tbody td:first-child {
168
+.hack.dark table tbody td:first-child {
169 169
   color: inherit;
170
+  font-weight: initial;
171
+}
172
+.hack.dark table tr th {
173
+  background-color: #1976d220;
174
+}
175
+.hack.dark table tr td a {
176
+  border: 1px solid #2196f340;
177
+  padding: 0.25rem;
178
+}
179
+.hack.dark table tr td a:hover {
180
+  transition: all 300ms ease;
181
+  background-color: #ff2e8860;
182
+  border-color: #2196f360;
183
+}
184
+.hack.dark table tr td a:not(:hover) {
185
+  transition: all 300ms ease;
186
+  background-color: #ff2e8825;
170 187
 }

+ 3
- 0
docs/assets/css/custom.css View File

@@ -46,6 +46,9 @@ a[itemprop="url"]:hover {
46 46
 .hack.dark table tr:nth-child(odd) td {
47 47
   background-color: #1976d220;
48 48
 }
49
+.hack.dark table tr td a {
50
+  display: block;
51
+}
49 52
 caption {
50 53
   margin-bottom: 20px;
51 54
   text-align: left;

+ 1
- 1
docs/config/_default/config.toml View File

@@ -19,7 +19,7 @@
19 19
 
20 20
 baseurl = "https://after-dark.habd.as/" # Controls base URL sitewide
21 21
 title = "After Dark" # Homepage title and page title suffix
22
-paginate = 37 # Number of items to show before paginating
22
+paginate = 38 # Number of items to show before paginating
23 23
 copyright = "Copyright &copy; Josh Habdas. Licensed under <a target=\"_blank\" rel=\"external noopener license\" href=\"https://www.gnu.org/licenses/agpl.html\">AGPL-3.0-or-later</a>."
24 24
 
25 25
 # Controls default theme and theme components

+ 29
- 21
docs/content/_index.md View File

@@ -10,9 +10,9 @@ images = [
10 10
   license = "agpl-3.0-or-later"
11 11
 [[spotlight]]
12 12
   name = "workflow"
13
-  title = "Streamlined Workflow"
13
+  title = "Developer Focused"
14 14
   description = "Develop and publish websites cross-platform using a <strong>single codebase</strong> with just <strong>one dependency</strong> and capabilities designed to make you more productive:"
15
-  icon = "options"
15
+  icon = "code"
16 16
 [[spotlight]]
17 17
   name = "speed"
18 18
   title = "Incredibly Fast"
@@ -31,18 +31,32 @@ images = [
31 31
     rel = "external nofollow noopener"
32 32
 [[spotlight]]
33 33
   name = "privacy"
34
-  title = "Privacy Focused"
34
+  title = "Privacy Aware"
35 35
   description = "Develop your entire site <strong><i>without</i> Internet</strong> connectivity and <i>expose</i> an ephemeral Web server with e2e encryption and <strong>real-time traffic inspection</strong>."
36 36
   icon = "eye"
37 37
   [[spotlight.link]]
38
-    href = "/feature/air-gapping/"
38
+    href = "/feature/work-offline/"
39 39
     text = "Work Offline"
40 40
   [[spotlight.link]]
41 41
     href = "/feature/referrer-policy/"
42
-    text = "Referrer Policy"
42
+    text = "Hide Referrals"
43 43
   [[spotlight.link]]
44 44
     href = "/feature/ephemeral-hosting/"
45
-    text = "SSH Hosting"
45
+    text = "SSH Host"
46
+[[spotlight]]
47
+  name = "security"
48
+  title = "Securely Designed"
49
+  description = "Verify the <i>authenticity</i> of your installation using secure cryptographic hashes and use <abbr title=\"Content Security Policy\">CSP</abbr>, <abbr title=\"Sub-Resource Integrity\">SRI</abbr> and Referrer Policy to <strong>lock down your content</strong>."
50
+  icon = "lock"
51
+  [[spotlight.link]]
52
+    href = "/feature/content-security-policy/"
53
+    text = "Content Policy"
54
+  [[spotlight.link]]
55
+    href = "/validate/"
56
+    text = "Check Integrity"
57
+  [[spotlight.link]]
58
+    href = "/feature/#security"
59
+    text = "See All"
46 60
 [[spotlight]]
47 61
   name = "graphics"
48 62
   title = "Advanced Graphics"
@@ -61,7 +75,7 @@ images = [
61 75
   name = "customize"
62 76
   title = "Easily Customized"
63 77
   description = "Toggle between 1 of 8 <strong><i>customizable</i> skin styles</strong> or disable them entirely and use custom layouts and styles to take complete design control."
64
-  icon = "compose"
78
+  icon = "options"
65 79
   [[spotlight.link]]
66 80
     href = "/feature/custom-homepage/"
67 81
     text = "Homepage"
@@ -94,20 +108,6 @@ images = [
94 108
   [[spotlight.link]]
95 109
     href = "/module/toxic-swamp/"
96 110
     text = "Learn More"
97
-[[spotlight]]
98
-  name = "security"
99
-  title = "Securely Designed"
100
-  description = "Verify the <i>authenticity</i> of your installation using secure <a href=\"/feature/release-hashes\">cryptographic hashes</a> and use <abbr title=\"Content Security Policy\">CSP</abbr>, <abbr title=\"Sub-Resource Integrity\">SRI</abbr> and Referrer Policy to <strong>lock down your content</strong>."
101
-  icon = "lock"
102
-  [[spotlight.link]]
103
-    href = "/feature/content-security-policy/"
104
-    text = "Content Policy"
105
-  [[spotlight.link]]
106
-    href = "/validate/"
107
-    text = "Check Integrity"
108
-  [[spotlight.link]]
109
-    href = "/feature/#security"
110
-    text = "See All"
111 111
 [[spotlight]]
112 112
   name = "extras"
113 113
   title = "Batteries Included"
@@ -122,6 +122,14 @@ images = [
122 122
   [[spotlight.link]]
123 123
     href = "/module/voyeur/"
124 124
     text = "Fathom"
125
+[[spotlight]]
126
+  name = "builds"
127
+  title = "Extended Builds"
128
+  description = "Create **high-performance Hugo builds** using Alpine Linux with Musl. Builds Hugo Extended binary <i>with Sass support</i> using Docker **directly from source**."
129
+  icon = "export"
130
+  [[spotlight.link]]
131
+    href = "/feature/extended-builds/"
132
+    text = "Create Build Now"
125 133
 +++
126 134
 
127 135
 {{< hackcss-form action="/feature/quick-install" >}}

+ 2
- 0
docs/content/feature/_index.id.md View File

@@ -6,3 +6,5 @@ description = "Menjelajahi bermacam-macam fitur yang tersedia untuk anda di Afte
6 6
   date = "2019"
7 7
   license = "agpl-3.0-or-later"
8 8
 +++
9
+
10
+Pilih fitur untuk mempelajari lebih lanjut atau menjalankan <a href="./quick-install">Instal Cepat</a> untuk men-download dan menginstal setelah Dark dan mencoba salah satu dari ini sendiri.

+ 1
- 1
docs/content/feature/_index.md View File

@@ -7,4 +7,4 @@ description = "Explore the many features available to you in After Dark."
7 7
   license = "agpl-3.0-or-later"
8 8
 +++
9 9
 
10
-Choose a feature to learn more or run the <a href="./quick-install">Quick Install</a> to download and install After Dark and use the <a href="./online-help">Online Help</a> try any of these yourself.
10
+Choose a feature to learn more or run <a href="./quick-install">Quick Install</a> to download and install After Dark and try any of these yourself.

+ 12
- 6
docs/content/feature/code-highlighter.id.md View File

@@ -33,18 +33,24 @@ Menghasilkan kode yang dihighlight seperti berikut:
33 33
 </div>
34 34
 ```
35 35
 
36
-Atau gabungkan {{% external href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode" %}}`highlight` shortcode{{% /external %}} dan `include` [Snippet](../snippets):
36
+Atau gunakan shortcode highlight yang disediakan oleh Hugo:
37
+
38
+Atau gabungkan {{% external href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode" %}}highlight shortcode{{% /external %}} disediakan oleh Hugo:
37 39
 
38 40
 ```html
39
-{{</* highlight css */>}}
40
-{{</* include file="themes/after-dark/static/css/syntax.css" */>}}
41
+{{</* highlight python */>}}
42
+@app.on_message(Filters.private)
43
+def hello(client, message):
44
+    message.reply_text("Hello {}".format(message.from_user.first_name))
41 45
 {{</* /highlight */>}}
42 46
 ```
43 47
 
44
-Untuk melihat CSS yang digunakan untuk menampilkan highlight highlighter yang disorot:
48
+Untuk menambahkan nomor baris dan sorotan:
45 49
 
46
-{{< highlight css >}}
47
-{{< include type="source" file="themes/after-dark/static/css/syntax.css" >}}
50
+{{< highlight python "linenos=inline,linenostart=5,hl_lines=2" >}}
51
+@app.on_message(Filters.private)
52
+def hello(client, message):
53
+    message.reply_text("Hello {}".format(message.from_user.first_name))
48 54
 {{< /highlight >}}
49 55
 
50 56
 Tidak menyukai warnanya? Tidak masalah. Gunakan perintah `hugo gen chromastyles` untuk {{< external href="https://gohugo.io/content-management/syntax-highlighting/#generate-syntax-highlighter-css" text="generate your own" />}} `syntax.css` stylesheet dari {{< external href="https://help.farbox.com/pygments.html" text="style gallery" />}} dan menyesuaikannya menggunakan tujuan umum {{< external href="https://git.habd.as/comfusion/atom-one-chroma" text="Atom One Chroma" />}} tema rol sintaks.

+ 11
- 7
docs/content/feature/code-highlighter.md View File

@@ -15,7 +15,7 @@ After Dark uses a customized version of {{< external href="https://atom.io/theme
15 15
 <style>.card-content .inner { overflow: scroll; height: 200px; }</style>
16 16
 {{< hackcss-card header="Supported Languages" text="ABNF, ANTLR, APL, ActionScript, ActionScript 3, Ada, Angular2, ApacheConf, AppleScript, Arduino, Awk, BNF, Ballerina, Base Makefile, Bash, Batchfile, BlitzBasic, Brainfuck, C, C#, C++, CFEngine3, CMake, COBOL, CSS, Cap'n Proto, Ceylon, ChaiScript, Cheetah, Clojure, CoffeeScript, Common Lisp, Coq, Crystal, Cython, DTD, Dart, Diff, Django/Jinja, Docker, EBNF, Elixir, Elm, EmacsLisp, Erlang, FSharp, Factor, Fish, Forth, Fortran, GAS, GDScript, GLSL, Genshi, Genshi HTML, Genshi Text, Gnuplot, Go, Go HTML Template, Go Text Template, Graphql, Groovy, HTML, HTTP, Handlebars, Haskell, Haxe, Hexdump, Hy, INI, Idris, Io, JSON, JSX, Java, JavaScript, Julia, Kotlin, LLVM, Lighttpd configuration file, Lua, Mako, Mason, Mathematica, Matlab, MiniZinc, Modula-2, MorrowindScript, MySQL, Myghty, NASM, Newspeak, Nginx configuration file, Nim, Nix, OCaml, Objective-C, Octave, Org Mode, PHP, PL/pgSQL, POVRay, PacmanConf, Perl, Pig, PkgConfig, PostScript, PostgreSQL SQL dialect, PowerShell, Prolog, Protocol Buffer, Puppet, Python, Python 3, QBasic, R, Racket, Ragel, Rexx, Ruby, Rust, SCSS, SPARQL, SQL, Sass, Scala, Scheme, Scilab, Smalltalk, Smarty, Snobol, Solidity, SquidConf, Swift, TASM, TOML, Tcl, Tcsh, TeX, Termcap, Terminfo, Terraform, Thrift, Transact-SQL, Turing, Turtle, Twig, TypeScript, TypoScript, TypoScriptCssData, TypoScriptHtmlData, VHDL, VimL, WDTE, XML, Xorg, YAML, cfstatement, markdown, reStructuredText, reg, systemverilog, verilog" />}}
17 17
 
18
-To activate the highlighter use the Hugo {{% external href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode" %}}`highlight` shortcode{{% /external %}} or indicate the {{< external href="https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages" text="highlighting language" />}} in a fenced code block within your markdown:
18
+To activate the highlighter indicate the {{< external href="https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages" text="highlighting language" />}} in a fenced code block within your markdown:
19 19
 
20 20
 ````
21 21
 ```go-html-template
@@ -33,18 +33,22 @@ Resulting in the following highlighted code:
33 33
 </div>
34 34
 ```
35 35
 
36
-Or combine with the {{% external href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode" %}}`highlight` shortcode{{% /external %}} and `include` [Snippet](../snippets):
36
+Or use the {{% external href="https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode" %}}highlight shortcode{{% /external %}} provided by Hugo:
37 37
 
38 38
 ```html
39
-{{</* highlight css */>}}
40
-{{</* include file="themes/after-dark/static/css/syntax.css" */>}}
39
+{{</* highlight python */>}}
40
+@app.on_message(Filters.private)
41
+def hello(client, message):
42
+    message.reply_text("Hello {}".format(message.from_user.first_name))
41 43
 {{</* /highlight */>}}
42 44
 ```
43 45
 
44
-To see the CSS used to display the highlighter highlighting highlighted:
46
+To add line numbers and highlighting:
45 47
 
46
-{{< highlight css >}}
47
-{{< include type="source" file="themes/after-dark/static/css/syntax.css" >}}
48
+{{< highlight python "linenos=inline,linenostart=5,hl_lines=2" >}}
49
+@app.on_message(Filters.private)
50
+def hello(client, message):
51
+    message.reply_text("Hello {}".format(message.from_user.first_name))
48 52
 {{< /highlight >}}
49 53
 
50 54
 Not feeling the colors? No problem. Use the `hugo gen chromastyles` command to {{< external href="https://gohugo.io/content-management/syntax-highlighting/#generate-syntax-highlighter-css" text="generate your own" />}} `syntax.css` stylesheet from the {{< external href="https://help.farbox.com/pygments.html" text="style gallery" />}} and customize it using the general-purpose {{< external href="https://git.habd.as/comfusion/atom-one-chroma" text="Atom One Chroma" />}} syntax theme-roller.

+ 2
- 2
docs/content/feature/ephemeral-hosting.id.md View File

@@ -10,9 +10,9 @@ features = ["related content", "snippets"]
10 10
   license = "agpl-3.0-or-later"
11 11
 +++
12 12
 
13
-Menggunakan {{< external href="https://serveo.net" text="Serveo" />}} secara singkat anda dapat membuka situs anda ke internet, tanpa perlu mendaftar. Use this alongside [Air Gapping]({{< relref "air-gapping" >}}) to quietly poke a hole through your NAT or firewall to move information more discretely.
13
+Menggunakan {{< external href="https://serveo.net" text="Serveo" />}} secara singkat anda dapat membuka situs anda ke internet, tanpa perlu mendaftar. Use this to [Work Offline]({{< relref "work-offline" >}}) and quietly poke a hole through your NAT or firewall to move information more discretely.
14 14
 
15
-{{% hackcss-alert type="warning" %}}**Warning:** No form of communication over the Internet is 100% secure. If you don't trust Serveo or SSH hire a {{< external "https://opaque.link/post/dropgang/" "Dropgang" />}} or use the good 'ol sneakernet.{{% /hackcss-alert %}}
15
+{{% hackcss-alert type="warning" %}}**Warning:** No form of communication over the Internet is 100% secure.{{% /hackcss-alert %}}
16 16
 
17 17
 Sajikan dan buka situs anda dengan perintah berikut:
18 18
 

+ 2
- 2
docs/content/feature/ephemeral-hosting.md View File

@@ -10,9 +10,9 @@ features = ["related content", "snippets"]
10 10
   license = "agpl-3.0-or-later"
11 11
 +++
12 12
 
13
-Using {{< external href="https://serveo.net" text="Serveo" />}} you may briefly expose your site to the Internet with end-to-end encryption, no sign-up required. Use this alongside [Air Gapping]({{< relref "air-gapping" >}}) to quietly poke a hole through your NAT or firewall to move information more discretely.
13
+Using {{< external href="https://serveo.net" text="Serveo" />}} you may briefly expose your site to the Internet with end-to-end encryption, no sign-up required. Use this to [Work Offline]({{< relref "work-offline" >}}) and quietly poke a hole through your NAT or firewall to move information more discretely.
14 14
 
15
-{{% hackcss-alert type="warning" %}}**Warning:** No form of communication over the Internet is 100% secure. If you don't trust Serveo or SSH hire a {{< external "https://opaque.link/post/dropgang/" "Dropgang" />}} or use the good 'ol sneakernet.{{% /hackcss-alert %}}
15
+{{% hackcss-alert type="warning" %}}**Warning:** No form of communication over the Internet is 100% secure.{{% /hackcss-alert %}}
16 16
 
17 17
 Serve and expose your site with the following command:
18 18
 

+ 37
- 0
docs/content/feature/extended-builds.id.md View File

@@ -0,0 +1,37 @@
1
++++
2
+title = "Extended Builds"
3
+description = "Build Hugo with Sass and Go CDK Deploy support."
4
+categories = ["core"]
5
+tags = ["docker", "container", "sass", "cloud"]
6
+features = ["code highlighter", "related content"]
7
+[[copyright]]
8
+  owner = "Josh Habdas"
9
+  date = "2019"
10
+  license = "agpl-3.0-or-later"
11
++++
12
+
13
+After Dark ships with the ability to build Hugo from tagged-version source. Supply a version tag and let Docker Machine build you a high-performance extended Hugo build with integrated Sass and Go CDK deployment support.
14
+
15
+To use install Docker then run the following command:
16
+
17
+```sh
18
+cd after-dark/docker/hugo && docker build .
19
+```
20
+
21
+Build container uses Alpine and includes `musl-dev` for high-performance. Update the `HUGO_VERSION` to get a specific Hugo release built. Upon successful build extract the resulting `hugo` binary out of the scratch container like:
22
+
23
+```sh
24
+docker create -it --name temp f2b785583ce8 sh && \
25
+sudo docker cp temp:/hugo /usr/local/bin && \
26
+docker rm -fv temp
27
+```
28
+
29
+Where `f2b785583ce8` is the scratch container's Image ID and `/usr/local/bin` is the destination on the host. Place executable in most appropriate directory.
30
+
31
+For builds without Sass support enabled turn off `CGO_ENABLED`, pass in a phony value to `BUILD_TAGS`, create another build and give it a docker tag:
32
+
33
+```sh
34
+docker tag $(docker images -q | head -n 1) gohugoio/hugo:v0.56.3
35
+```
36
+
37
+It's recommended at least 2GB of storage space is available when running builds. The resulting binary inside the scratch container is less than 50MB.

+ 37
- 0
docs/content/feature/extended-builds.md View File

@@ -0,0 +1,37 @@
1
++++
2
+title = "Extended Builds"
3
+description = "Build Hugo with Sass and Go CDK Deploy support."
4
+categories = ["core"]
5
+tags = ["docker", "container", "sass", "cloud"]
6
+features = ["code highlighter", "related content"]
7
+[[copyright]]
8
+  owner = "Josh Habdas"
9
+  date = "2019"
10
+  license = "agpl-3.0-or-later"
11
++++
12
+
13
+After Dark ships with the ability to build Hugo from tagged-version source. Supply a version tag and let Docker Machine build you a high-performance extended Hugo build with integrated Sass and Go CDK deployment support.
14
+
15
+To use install Docker then run the following command:
16
+
17
+```sh
18
+cd after-dark/docker/hugo && docker build .
19
+```
20
+
21
+Build container uses Alpine and includes `musl-dev` for high-performance. Update the `HUGO_VERSION` to get a specific Hugo release built. Upon successful build extract the resulting `hugo` binary out of the scratch container like:
22
+
23
+```sh
24
+docker create -it --name temp f2b785583ce8 sh && \
25
+sudo docker cp temp:/hugo /usr/local/bin && \
26
+docker rm -fv temp
27
+```
28
+
29
+Where `f2b785583ce8` is the scratch container's Image ID and `/usr/local/bin` is the destination on the host. Place executable in most appropriate directory.
30
+
31
+For builds without Sass support enabled turn off `CGO_ENABLED`, pass in a phony value to `BUILD_TAGS`, create another build and give it a docker tag:
32
+
33
+```sh
34
+docker tag $(docker images -q | head -n 1) gohugoio/hugo:v0.56.3
35
+```
36
+
37
+It's recommended at least 2GB of storage space is available when running builds. The resulting binary inside the scratch container is less than 50MB.

+ 1
- 1
docs/content/feature/keywords-meta.id.md View File

@@ -23,4 +23,4 @@ keywords = [
23 23
 ]
24 24
 ```
25 25
 
26
-Meskipun dianggap tidak relevan untuk mencari peringkat, kata kunci dapat menjadi cara yang berguna untuk mendokumentasikan istilah pencarian target dan memberikan makna lebih semantik ke halaman pencarian anda.
26
+Meskipun dianggap tidak relevan untuk mencari peringkat, kata kunci dapat menjadi cara yang berguna untuk mendokumentasikan istilah pencarian target dan frase kunci yang digunakan dalam <abbr title="Bayar Per Klik">PPC</abbr> kampanye.

+ 1
- 1
docs/content/feature/keywords-meta.md View File

@@ -23,4 +23,4 @@ keywords = [
23 23
 ]
24 24
 ```
25 25
 
26
-While not considered relevant to search rankings, keywords can be a useful way to document target search terms and give more semantic meaning to your pages.
26
+While not considered relevant to search rankings, keywords can be a useful way to document target search terms and key phrases used in <abbr title="Pay Per Click">PPC</abbr> campaigns.

+ 2
- 2
docs/content/feature/last-modified.md View File

@@ -12,7 +12,7 @@ features = ["code highlighter", "snippets", "related content"]
12 12
 
13 13
 Denote posts with substantive changes or simply draw older, more relevant posts closer to the top of the listings with last modified.
14 14
 
15
-Modifications will be made obvious to visitors with a visible callout in post summaries and the original publish date will be kept intact in the post bylines.
15
+Modifications will be made obvious to visitors with a visible callout in post summaries and the original publish date will be kept intact in the [Post Bylines](../post-bylines).
16 16
 
17 17
 For robots, making this change will automatically update Schema Structured Data, RSS feeds and the `lastmod` setting in your {{< external href="https://gohugo.io/templates/sitemap-template/" text="Sitemap" />}}.
18 18
 
@@ -32,4 +32,4 @@ date = "2017-02-02"
32 32
 publishdate = "2016-11-21"
33 33
 ```
34 34
 
35
-It's also possible to future and expiry dates for content in Hugo. To learn more see the documentation on {{< external href="https://gohugo.io/getting-started/usage/#draft-future-and-expired-content" text="Draft, Future, and Expired Content" />}}.
35
+It's also possible to set future and expiry dates for content in Hugo. To learn more see the documentation on {{< external href="https://gohugo.io/getting-started/usage/#draft-future-and-expired-content" text="Draft, Future, and Expired Content" />}}.

+ 1
- 1
docs/content/feature/link-typing.id.md View File

@@ -25,7 +25,7 @@ prev = "/series/learn-to-code/part-one/"
25 25
 next = "/series/learn-to-code/part-three/"
26 26
 ```
27 27
 
28
-Gunakan jenis tautan `prev` dan `next` untuk artikel tersegmentasi, [Live Blog Postings](https://schema.org/LiveBlogPosting) atau untuk meniru ciri-ciri taksonomi `series` jika tidak ada taksonomi seri.
28
+Gunakan jenis tautan `prev` dan `next` untuk artikel tersegmentasi, {{< external "https://schema.org/LiveBlogPosting" "Live Blog Postings" />}} atau untuk meniru ciri-ciri taksonomi `series` jika tidak ada taksonomi seri.
29 29
 
30 30
 Jenis tautan biasanya ditampilkan di bagian atas halaman di browser teks seperti {{< external href="http://elinks.or.cz" text="ELinks" />}} sebagai bentuk navigasi tambahan dan dapat membantu robot dan pengguna lebih memahami hubungan antar konten anda.
31 31
 

+ 1
- 1
docs/content/feature/link-typing.md View File

@@ -25,7 +25,7 @@ prev = "/series/learn-to-code/part-one/"
25 25
 next = "/series/learn-to-code/part-three/"
26 26
 ```
27 27
 
28
-Use `prev` and `next` link types for segmented articles, [Live Blog Postings](https://schema.org/LiveBlogPosting) or to mimic the traits of a `series` taxonomy if no series taxonomy is present.
28
+Use `prev` and `next` link types for segmented articles, {{< external "https://schema.org/LiveBlogPosting" "Live Blog Postings" />}} or to mimic the traits of a `series` taxonomy if no series taxonomy is present.
29 29
 
30 30
 Link Types are commonly shown at the top of the page in text browsers such as {{< external href="http://elinks.or.cz" text="ELinks" />}} as an auxiliary form of navigation and can help robots and users better understand relationships between your content.
31 31
 

+ 2
- 2
docs/content/feature/quick-install.id.md View File

@@ -1,5 +1,5 @@
1 1
 +++
2
-title = "Quick Install"
2
+title = "Instal Cepat"
3 3
 description = "Hanya satu perintah yang anda butuhkan untuk membuat website baru."
4 4
 categories = ["core"]
5 5
 tags = ["setup", "installation", "scripts"]
@@ -71,7 +71,7 @@ Skrip harus selesai dalam 5-10 detik sehingga menghasilkan sampel situs dan doku
71 71
   caption="After Dark Quick Install running to completion in Terminal on Deepin Manjaro."
72 72
 >}}
73 73
 
74
-Situs baru Anda akan disebut `flying-toasters`. Ubah ke nama proyek Anda.
74
+Situs baru Anda akan disebut `flying-toaster`. Ubah ke nama proyek anda kapan saja anda suka. Akses situs dengan menavigasi ke https://localhost:1313.
75 75
 
76 76
 # Konfigurasi Multi-situs (Lanjutan)
77 77
 

+ 2
- 2
docs/content/feature/quick-install.md View File

@@ -75,11 +75,11 @@ Script should complete in 5-10 seconds resulting in a sample site and help docs:
75 75
   caption="After Dark Quick Install running to completion in Terminal on Deepin Manjaro."
76 76
 >}}
77 77
 
78
-Your new site will be called `flying-toasters`. Change it to the name of your project.
78
+Your new site will be called `flying-toasters`. Change it to the name of your project anytime you like. Access site by navigating to https://localhost:1313.
79 79
 
80 80
 # Multi-site Configuration (Advanced)
81 81
 
82
-After Dark enables multi-site management from a single installation. To manage multiple websites use the `-c` and `-d` flags to specify the `content` and `destination` directories, respectively
82
+After Dark enables multi-site management from a single installation. To manage multiple websites use the `-c` and `-d` flags to specify the `content` and `destination` directories, respectively.
83 83
 
84 84
 For example, to generate an audio site using the current After Dark installation create an executable script to generate the site:
85 85
 

+ 8
- 1
docs/content/feature/skin-styles.id.md View File

@@ -15,7 +15,14 @@ alias = [
15 15
 
16 16
 After Dark menggunakan {{< external href="https://hackcss.egoist.moe" text="hackcss" />}} untuk menyediakan empat palet warna dan dua mode tampilan. Beralih diantara mereka dari {{< external href="https://gohugo.io/getting-started/configuration/" text="site configuration" />}} anda untuk 8 kemungkinan kombinasi:
17 17
 
18
-<style>table[summary] td pre { margin:0 }</style>
18
+<style>
19
+  table[summary] td pre {
20
+    margin: 0;
21
+  }
22
+  .hack.dark table tr:nth-child(odd) td {
23
+    background-color: initial;
24
+  }
25
+</style>
19 26
 <table summary="Display Variations">
20 27
   <thead>
21 28
     <tr>

+ 8
- 1
docs/content/feature/skin-styles.md View File

@@ -15,7 +15,14 @@ aliases = [
15 15
 
16 16
 After Dark uses {{< external href="https://hackcss.egoist.moe" text="hackcss" />}} to provide four color palettes and two display modes. Toggle between them from your {{< external href="https://gohugo.io/getting-started/configuration/" text="site configuration" />}} for 8 possible combinations:
17 17
 
18
-<style>table[summary] td pre { margin: 0; }</style>
18
+<style>
19
+  table[summary] td pre {
20
+    margin: 0;
21
+  }
22
+  .hack.dark table tr:nth-child(odd) td {
23
+    background-color: initial;
24
+  }
25
+</style>
19 26
 <table summary="Color palette and display mode settings">
20 27
   <thead>
21 28
     <tr>

+ 1
- 1
docs/content/feature/social-meta.md View File

@@ -10,7 +10,7 @@ features = ["code highlighter", "snippets", "related content"]
10 10
   license = "agpl-3.0-or-later"
11 11
 +++
12 12
 
13
-After Dark provides {{< external text="Open Graph Protocol" href="http://opengraphprotocol.org" />}} and {{< external href="https://developer.twitter.com/en/docs/tweets/optimize-with-cards" text="Twitter Cards" />}} metadata in pages to achieve rich sharing cards on Facebook, Twitter and more:
13
+After Dark provides {{< external text="Open Graph Protocol" href="http://opengraphprotocol.org" />}} and {{< external href="https://developer.twitter.com/en/docs/tweets/optimize-with-cards" text="Twitter Cards" />}} metadata in pages to achieve rich sharing cards on WhatsApp, Twitter, Telegram and more:
14 14
 
15 15
 ![Open Graph sharing card screenshot](/images/instant-view-fs8.png "Example Open Graph sharing card produced by After Dark")
16 16
 

+ 1
- 1
docs/content/feature/structured-data.id.md View File

@@ -27,4 +27,4 @@ Pelajari lebih lanjut tentang data terstruktur menggunakan sumber daya berikut:
27 27
 - {{< external href="https://moz.com/learn/seo/schema-structured-data" text="Schema Structured Data on Moz" />}}
28 28
 
29 29
 
30
-Gunakan [Webmaster Tools](../webmaster-tools/) untuk memvalidasi data terstruktur. Ini dapat dilakukan dari mesin pengembangan menggunakan [ephemeral hosting](../air-gapping/#hosting-ephemeral-dengan-enkripsi-end-to-end).
30
+Gunakan [Webmaster Tools](../webmaster-tools/) untuk memvalidasi data terstruktur. Ini dapat dilakukan dari mesin pengembangan menggunakan [ephemeral hosting](../ephemeral-hosting/).

+ 1
- 1
docs/content/feature/structured-data.md View File

@@ -33,4 +33,4 @@ Learn more about structured data using the following resources:
33 33
 - {{< external href="https://moz.com/learn/seo/schema-structured-data" text="Schema Structured Data on Moz" />}}
34 34
 
35 35
 
36
-Use [Webmaster Tools](../webmaster-tools/) to validate structured data. This can be done from a development machine using [ephemeral hosting](../air-gapping/#ephemeral-hosting-with-end-to-end-encryption).
36
+Use [Webmaster Tools](../webmaster-tools/) to validate structured data. This can be done from a development machine using [ephemeral hosting](../ephemeral-hosting/).

+ 12
- 1
docs/content/feature/svg-favicon.id.md View File

@@ -10,11 +10,16 @@ feature = ["code highlighter", "snippets", "related content"]
10 10
   license = "agpl-3.0-or-later"
11 11
 +++
12 12
 
13
-After Dark dikirimkan dengan 169B yang dioptimalkan [^1] SVG favicon tertanam di setiap halaman:
13
+After Dark dikirimkan dengan 169B yang dioptimalkan[^1] SVG favicon tertanam di setiap halaman:
14 14
 
15
+<details>
16
+<summary>Perluas untuk melihat kode</summary>
15 17
 {{< highlight html >}}
16 18
 {{< include "themes/after-dark/layouts/partials/head/favicon.html" >}}
17 19
 {{< /highlight >}}
20
+</details>
21
+
22
+{{% hackcss-alert type="info" %}}**Catatan**: HTML (Go) Komentar template yang dilucuti selama generasi situs.{{% /hackcss-alert %}}
18 23
 
19 24
 Favicon adalah segitiga miring berwarna hitam dalam bentuk tepee seperti yang ditunjukkan[^2] di [Bantuan Online](../online-help) [Overview](/). Pusat segitiga menggunakan ruang negatif untuk memberikan ilusi segitiga sama sisi kedua dalam bentuk piramida, atau api terbuka, yang terkandung di dalam.
20 25
 
@@ -71,6 +76,12 @@ $ mkdir -p layouts/partials/head
71 76
 $ cp themes/after-dark/layouts/partials/head/favicon.html layouts/partials/head
72 77
 ```
73 78
 
79
+Ganti SVG dengan grafik lain jika diinginkan:
80
+
81
+```html
82
+<link rel="icon" sizes="128x128" href="/favicon.png">
83
+```
84
+
74 85
 Jika mengoptimalkan pengalaman platform lakukan dari dalam `favicon.html`:
75 86
 
76 87
 {{< highlight go-html-template "linenos=inline" >}}

+ 14
- 3
docs/content/feature/svg-favicon.md View File

@@ -12,9 +12,14 @@ features = ["code highlighter", "snippets", "related content"]
12 12
 
13 13
 After Dark ships with an 169B optimized[^1] SVG favicon embedded into every page:
14 14
 
15
+<details>
16
+<summary>Expand to view code</summary>
15 17
 {{< highlight html >}}
16 18
 {{< include "themes/after-dark/layouts/partials/head/favicon.html" >}}
17 19
 {{< /highlight >}}
20
+</details>
21
+
22
+{{% hackcss-alert type="info" %}}**Note**: HTML (Go) template comments are stripped out during site generation.{{% /hackcss-alert %}}
18 23
 
19 24
 The favicon is a black-colored oblique triangle in the shape of a tepee as shown[^2] on the [Online Help](../online-help) [Overview](/). The center of the triangle uses negative space to give the illusion of a second equilateral triangle in the shape of a pyramid, or open fire, contained within.
20 25
 
@@ -67,13 +72,19 @@ Adjust it from `favicon.html` in the site `layouts/partials/head` directory:
67 72
 If the file doesn't exist yet, copy it from the theme default:
68 73
 
69 74
 ```sh
70
-$ mkdir -p layouts/partials/head
71
-$ cp themes/after-dark/layouts/partials/head/favicon.html layouts/partials/head
75
+mkdir -p layouts/partials/head && \
76
+cp themes/after-dark/layouts/partials/head/favicon.html layouts/partials/head
77
+```
78
+
79
+Replace SVG with another graphic if desired:
80
+
81
+```html
82
+<link rel="icon" sizes="128x128" href="/favicon.png">
72 83
 ```
73 84
 
74 85
 If optimizing for platform experiences do so from within `favicon.html`:
75 86
 
76
-{{< highlight go-html-template "linenos=inline" >}}
87
+{{< highlight go-html-template >}}
77 88
 <meta name="apple-mobile-web-app-capable" content="yes">
78 89
 <meta name="apple-mobile-web-app-status-bar-style" content="black">
79 90
 <meta name="apple-mobile-web-app-title" content="{{ .Site.Title }}">

+ 1
- 0
docs/content/feature/webmaster-tools.id.md View File

@@ -70,4 +70,5 @@ Memantau kinerja dari waktu ke waktu menggunakan {{< external href="https://spee
70 70
 
71 71
 ## Layanan Tambahan
72 72
 
73
+- {{< external "https://webmaster.yandex.com/tools/robotstxt/" />}}
73 74
 - {{< external "https://w3c.github.io/developers/tools/" />}}

+ 1
- 0
docs/content/feature/webmaster-tools.md View File

@@ -69,4 +69,5 @@ Monitor performance over time using {{< external href="https://speedtracker.org"
69 69
 
70 70
 ## Additional services
71 71
 
72
+- {{< external "https://webmaster.yandex.com/tools/robotstxt/" />}}
72 73
 - {{< external "https://w3c.github.io/developers/tools/" />}}

docs/content/feature/air-gapping.id.md → docs/content/feature/work-offline.id.md View File

@@ -1,9 +1,12 @@
1 1
 +++
2
-title = "Air Gapping"
2
+title = "Work Offline"
3 3
 description = "Membangun dan menjalankan seluruh situs anda tanpa akses internet."
4 4
 categories = ["security"]
5 5
 tags = ["privacy", "networking"]
6 6
 feature = ["related content"]
7
+aliases = [
8
+  "/feature/air-gapping"
9
+]
7 10
 [[copyright]]
8 11
   owner = "Josh Habdas"
9 12
   date = "2019"

docs/content/feature/air-gapping.md → docs/content/feature/work-offline.md View File

@@ -1,9 +1,12 @@
1 1
 +++
2
-title = "Air Gapping"
2
+title = "Work Offline"
3 3
 description = "Build and run your entire site without Internet access."
4 4
 categories = ["security"]
5 5
 tags = ["privacy", "networking"]
6 6
 features = ["related content"]
7
+aliases = [
8
+  "/feature/air-gapping"
9
+]
7 10
 [[copyright]]
8 11
   owner = "Josh Habdas"
9 12
   date = "2019"

+ 2
- 2
docs/content/module/toxic-swamp.md View File

@@ -371,11 +371,11 @@ Generate configuration with `Advanced Settings` specified:
371 371
       <strong>NOPE!</strong> Attempting to submit to unknown origin.
372 372
     {{< /hackcss-alert >}}
373 373
     {{< hackcss-alert type="warning" class="js-useonlinehelp" >}}
374
-      Please use <a href="/feature/online-help">Online Help</a> to generate configuration with <a href="/feature/air-gapping/">Air Gapping</a>.
374
+      Please use <a href="/feature/online-help/">Online Help</a> to generate configuration while <a href="/feature/work-offline/">Working Offline</a>.
375 375
     {{< /hackcss-alert >}}
376 376
     {{< hackcss-alert type="warning" class="js-disconnect" >}}
377 377
       <style>.js-disconnect { display: none }</style>
378
-      Please <a href="/feature/air-gapping">Disconnect</a> from the network before generating your configuration.
378
+      Please <a href="/feature/work-offline/">Disconnect</a> from the network before generating your configuration.
379 379
     {{< /hackcss-alert >}}
380 380
     {{< hackcss-formgroup name="addressgroup" >}}
381 381
       {{< hackcss-label for="address" >}}

+ 2
- 2
docs/content/shortcode/text-input.md View File

@@ -49,14 +49,14 @@ In [Form Group](../form-group) with warning [Label](../label) and [Help Block](.
49 49
 ```html
50 50
 {{</* hackcss-formgroup state="warning" >}}
51 51
   {{< hackcss-label for="key64" text="64-bit PGP key:" />}}
52
-  {{< hackcss-textinput type="text" id="key64" >}}
52
+  {{< hackcss-textinput spellcheck="false" type="text" id="key64" >}}
53 53
   {{< hackcss-helpblock text="In this format: BB73 67EE 9A70 A631" />}}
54 54
 {{< /hackcss-formgroup */>}}
55 55
 ```
56 56
 
57 57
 {{< hackcss-formgroup state="warning" >}}
58 58
   {{< hackcss-label for="key64" text="64-bit PGP key:" />}}
59
-  {{< hackcss-textinput type="text" id="key64" >}}
59
+  {{< hackcss-textinput spellcheck="false" type="text" id="key64" >}}
60 60
   {{< hackcss-helpblock text="In this format: BB73 67EE 9A70 A631" />}}
61 61
 {{< /hackcss-formgroup >}}
62 62
 

+ 1
- 1
docs/layouts/index.html View File

@@ -69,7 +69,7 @@ along with this program.  If not, see <https://www.gnu.org/licenses/>.
69 69
             <th scope="col" width="25%">Extras</th>
70 70
           </tr>
71 71
           <tr>
72
-            <td><a href="./feature/">37</a></td>
72
+            <td><a href="./feature/">38</a></td>
73 73
             <td><a href="./module/">4</a></td>
74 74
             <td><a href="./shortcode/">27+</a></td>
75 75
             <td><a href="./extra/">2</a></td>

+ 1
- 1
docs/layouts/partials/head/favicon.html View File

@@ -17,4 +17,4 @@ You should have received a copy of the GNU Affero General Public License
17 17
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
18 18
 */ -}}
19 19
 
20
-<link rel="icon" sizes="128x128" href="favicon.png">
20
+<link rel="icon" sizes="128x128" href="/favicon.png">

Loading…
Cancel
Save