Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Theme updates #7142

Merged
merged 3 commits into from
Nov 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/update-algolia-on-schedule.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ jobs:
- name: Set up Hugo
uses: peaceiris/actions-hugo@v2
with:
hugo-version: '0.125.7'
hugo-version: ${{ vars.HUGO_VERSION }}

- name: Checkout docs repo
uses: actions/checkout@v3
Expand Down
16 changes: 8 additions & 8 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,18 +70,18 @@ To Install the latest Node.js LTS release on Windows, navigate to the [downloads

### Install Hugo

The Linode documentation library is built using [Hugo](http://gohugo.io), an open-source static site generator. In order to preview your guide before submission, you need to install Hugo on your local computer. This site currently uses **Hugo v0.125.7**. To remain consistent in the testing and development process, it's recommended to install this version instead of using a newer version.
The Linode documentation library is built using [Hugo](http://gohugo.io), an open-source static site generator. In order to preview your guide before submission, you need to install Hugo on your local computer. This site currently uses **Hugo v0.138.0**. To remain consistent in the testing and development process, it's recommended to install this version instead of using a newer version.

Note: If you observe any issues on a newer version, please [file an issue](https://github.com/linode/docs/issues) in the docs GitHub repository.

#### macOS and Linux

To install Hugo, download the appropriate binary for your system, extract it, and move it to a directory within your PATH.

1. Download the file below that corresponds with the OS and platform on your local system. If you don't see your system on this list, you can find additional files on the [Hugo v0.125.7 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.125.7) under **Assets**.
1. Download the file below that corresponds with the OS and platform on your local system. If you don't see your system on this list, you can find additional files on the [Hugo v0.138.0 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.138.0) under **Assets**.

- **macOS:** https://github.com/gohugoio/hugo/releases/download/v0.125.7/hugo_extended_0.125.7_darwin-universal.tar.gz
- **Linux:** https://github.com/gohugoio/hugo/releases/download/v0.125.7/hugo_extended_0.125.7_Linux-64bit.tar.gz
- **macOS:** https://github.com/gohugoio/hugo/releases/download/v0.138.0/hugo_extended_0.138.0_darwin-universal.tar.gz
- **Linux:** https://github.com/gohugoio/hugo/releases/download/v0.138.0/hugo_extended_0.138.0_Linux-64bit.tar.gz

You can download this file through a terminal using the curl command, replacing [url] with the URL for your platform:

Expand Down Expand Up @@ -115,7 +115,7 @@ To install Hugo, download the appropriate binary for your system, extract it, an

While macOS and Linux are preferred by most of the core Linode Docs team, it's also possible to use Hugo on Windows.

1. Download the [hugo_extended_0.125.7_windows-amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.125.7/hugo_extended_0.125.7_windows-amd64.zip) file. Additional files for other operating systems can be found on the [Hugo v0.125.7 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.125.7) under **Assets**.
1. Download the [hugo_extended_0.138.0_windows-amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.138.0/hugo_extended_0.138.0_windows-amd64.zip) file. Additional files for other operating systems can be found on the [Hugo v0.138.0 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.138.0) under **Assets**.

1. Extract the file to the directory you'd like to install Hugo under, such as `C:\Hugo\bin`.

Expand Down Expand Up @@ -184,10 +184,10 @@ For more information about using Git, refer to the [official Git documentation](

This section is only relevant to contributors who have previously worked on the docs repo prior to the Tailwind v3 upgrade (which occurred on July 6th, 2023 in docs release v1.252.0). After you merge in changes from this release (and onward), you will likely notice display issues when previewing the site locally. This is due to Tailwind v3 and the way it integrates with Hugo (and our theme). To complete the upgrade locally and fix any display issues, follow the steps below.

1. Upgrade Hugo to v0.125.7. On macOS, run the following commands in a temporary folder (not in your docs repo):
1. Upgrade Hugo to v0.138.0. On macOS, run the following commands in a temporary folder (not in your docs repo):

curl -OL https://github.com/gohugoio/hugo/releases/download/v0.125.7/hugo_extended_0.125.7_darwin-universal.tar.gz
tar -xvzf hugo_extended_0.125.7_darwin-universal.tar.gz
curl -OL https://github.com/gohugoio/hugo/releases/download/v0.138.0/hugo_extended_0.138.0_darwin-universal.tar.gz
tar -xvzf hugo_extended_0.138.0_darwin-universal.tar.gz
mv hugo /usr/local/bin

If you are using a different operating system, refer to the [Install Hugo](#install-hugo) section above.
Expand Down
2 changes: 1 addition & 1 deletion _vendor/github.com/linode/linode-docs-theme/config.toml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion _vendor/modules.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# github.com/linode/linode-docs-theme v0.0.0-20241107185827-f54f3d0cc486
# github.com/linode/linode-docs-theme v0.0.0-20241112191537-cb59b44a8bd6
# github.com/linode/linode-website-partials v0.0.0-20241107184419-08ebb197096e
# github.com/gohugoio/hugo-mod-jslibs-dist/alpinejs/v3 v3.21300.20800
# github.com/gohugoio/hugo-mod-jslibs/turbo/v8 v8.20000.20400
Expand Down
2 changes: 1 addition & 1 deletion config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ anchor = "smart"
[security]
enableInlineShortcodes = false
[security.exec]
allow = ['^dart-sass-embedded$', '^go$', '^npx$', '^postcss$']
allow = ['^dart-sass-embedded$', '^go$', '^npx$', '^postcss$', '^git$']
osEnv = ['(?i)^(.*)$']

[security.funcs]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
slug: installing-snapd-certbot-dnf-shortguide
slug: installing-snapd-certbot-dnf-rhel-shortguide
title: "Shortguide"
description: "Shortguide"
authors: ["Linode"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ This guide is written for a non-root user. Commands that require elevated privil

{{% content "configuring-firewalld-for-web-traffic-shortguide" %}}

{{% content "installing-snapd-certbot-dnf-shortguide" %}}
{{% content "installing-snapd-certbot-dnf-rhel-shortguide" %}}

{{% content "requesting-certificate-apache-certbot-shortguide" %}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ This guide is written for a non-root user. Commands that require elevated privil

{{% content "configuring-firewalld-for-web-traffic-shortguide" %}}

{{% content "installing-snapd-certbot-dnf-shortguide" %}}
{{% content "installing-snapd-certbot-dnf-rhel-shortguide" %}}

{{% content "requesting-certificate-nginx-certbot-shortguide" %}}

Expand Down
2 changes: 1 addition & 1 deletion docs/marketplace-docs/guides/jenkins/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'

### Jenkins Options

{{% content "marketplace-required-limited-user-shortguide" %}}
{{% content "marketplace-required-limited-user-fields-shortguide" %}}
{{% content "marketplace-special-character-limitations-shortguide" %}}

{{% content "marketplace-custom-domain-fields-shortguide" %}}
Expand Down
4 changes: 3 additions & 1 deletion docs/marketplace-docs/guides/plesk/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,11 @@ license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
- **Suggested minimum plan:** All plan types and sizes can be used.

- **SOA Email Address** *(required):* An email address for free Let's Encrypt SSL.
{{% content "marketplace-required-limited-user-shortguide" %}}

{{% content "marketplace-required-limited-user-fields-shortguide" %}}

{{% content "marketplace-custom-domain-fields-shortguide" %}}

## Getting Started after Deployment

### Access your Plesk Site
Expand Down
2 changes: 1 addition & 1 deletion docs/marketplace-docs/guides/secure-your-server/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ This Marketplace App automatically configures a new Compute Instance with a limi

### Secure Your Server Setup Options

{{% content "marketplace-required-limited-user-shortguide" %}}
{{% content "marketplace-required-limited-user-fields-shortguide" %}}

{{% content "marketplace-custom-domain-fields-shortguide" %}}

Expand Down
2 changes: 1 addition & 1 deletion docs/marketplace-docs/guides/wireguard/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,6 @@ This test should be performed once you have configured a WireGuard client and up
| [**WireGuard**](https://www.wireguard.com) | VPN software. |
| [**UFW (UncomplicatedFireWall)**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. The Port assigned during the [WireGuard Options](#wireguard-options) step of the deployment will allow outgoing and incoming traffic. |

{{% content "marketplace-update-note" %}}
{{% content "marketplace-update-note-shortguide" %}}

"WireGuard" is a registered trademark of Jason A. Donenfeld.
2 changes: 1 addition & 1 deletion docs/marketplace-docs/guides/zabbix/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'

{{% content "marketplace-required-limited-user-fields-shortguide" %}}

{{% content "marketplace-custom-domains-field-shortguide" %}}
{{% content "marketplace-custom-domain-fields-shortguide" %}}

- **Zabbix Server Name:** Local hostname for Zabbix server. Defaults to `zabbix-server`

Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,5 @@ require (
github.com/gohugoio/hugo-mod-jslibs/turbo/v7 v7.20300.20000 // indirect
github.com/instantpage/instant.page v5.1.1+incompatible // indirect
github.com/linode/linode-api-docs/v4 v4.176.0 // indirect
github.com/linode/linode-docs-theme v0.0.0-20241107185827-f54f3d0cc486 // indirect
github.com/linode/linode-docs-theme v0.0.0-20241112191537-cb59b44a8bd6 // indirect
)
2 changes: 2 additions & 0 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -304,6 +304,8 @@ github.com/linode/linode-docs-theme v0.0.0-20241107173628-e39045c56363 h1:Q129Rq
github.com/linode/linode-docs-theme v0.0.0-20241107173628-e39045c56363/go.mod h1:f3XbKgch4DFA6jz2k7snVPDoQEiWwsJu4u54BbUiCKs=
github.com/linode/linode-docs-theme v0.0.0-20241107185827-f54f3d0cc486 h1:MFZMFqmpEcI7UK6b0Qp8rGLVefdDd5TzElLOACP1CWc=
github.com/linode/linode-docs-theme v0.0.0-20241107185827-f54f3d0cc486/go.mod h1:MCx/heCsE3R5qiYUpDueNgFiTG9TphMMgy4U+GiM0O0=
github.com/linode/linode-docs-theme v0.0.0-20241112191537-cb59b44a8bd6 h1:hSQHr/kOf7n7SZzHmgf6gwYLc+71/tCUHmLhka2YILs=
github.com/linode/linode-docs-theme v0.0.0-20241112191537-cb59b44a8bd6/go.mod h1:MCx/heCsE3R5qiYUpDueNgFiTG9TphMMgy4U+GiM0O0=
github.com/linode/linode-website-partials v0.0.0-20221205205120-b6ea1aaa59fb/go.mod h1:K1Em3lwb16JiCwNVftAFwWGhyB9Zkl/nXhxjBBUC1Ao=
github.com/linode/linode-website-partials v0.0.0-20221222200538-99862e429110/go.mod h1:K1Em3lwb16JiCwNVftAFwWGhyB9Zkl/nXhxjBBUC1Ao=
github.com/linode/linode-website-partials v0.0.0-20230201145731-a8703d0a954a/go.mod h1:K1Em3lwb16JiCwNVftAFwWGhyB9Zkl/nXhxjBBUC1Ao=
Expand Down
4 changes: 2 additions & 2 deletions netlify.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@ publish = "public"
command = "hugo version && hugo config && hugo --gc --minify -d public/docs;"

[context.production.environment]
HUGO_VERSION = "0.125.7"
HUGO_VERSION = "0.138.0"
HUGO_PARAMS_TESTENV="Netlify"

[context.deploy-preview.environment]
HUGO_VERSION = "0.125.7"
HUGO_VERSION = "0.138.0"
HUGO_PARAMS_TESTENV="Netlify"

[[plugins]]
Expand Down
Loading