letsencrypt / website

Let's Encrypt Website and Documentation
https://letsencrypt.org
Mozilla Public License 2.0
851 stars 576 forks source link
acme hugo isrg letsencrypt

Let's Encrypt Website

This is the repository for the main Let's Encrypt website.

This site is built with Hugo. It's entirely static, no server-side code/scripting.

To see your changes, install Hugo Extended, then run it with:

hugo server -F

And open http://localhost:1313/ in your browser. Note that the -F flag will show items to be published in the future (like blog posts with dates in the future).

If you update javascript, css or layouts, you can run tests with:

npm install && npm run build && npm test

Contributions welcome.

Troubleshooting with Hugo

If you see the error:

Failed to load translations in file "en.toml": unsupported file extension .toml

Your version of Hugo is probably too old. Please use the version specified in netlify.toml

Translations - internationalization (i18n)

To help with translation, please see TRANSLATION.md.

Creating new pages

When creating new pages you'll need to add a translation stub for each language. You can use the new-page.sh script to create these automatically:

Usage: ./new-page.sh <page-path> <page title>
Examples:
./new-page.sh my-page "My Page Title"
./new-page.sh post/my-post "My Post Title"
$ ./new-page.sh docs/new-page "My New Page"
Created page: ./content/vi/docs/new-page.md
Created page: ./content/sv/docs/new-page.md
Created page: ./content/he/docs/new-page.md
Created page: ./content/ja/docs/new-page.md
Created page: ./content/base-l10n/docs/new-page.md
Created page: ./content/it/docs/new-page.md
Created page: ./content/ru/docs/new-page.md
Created page: ./content/zh-cn/docs/new-page.md
Created page: ./content/uk/docs/new-page.md
Created page: ./content/sr/docs/new-page.md
Created page: ./content/zh-tw/docs/new-page.md
Created page: ./content/pt-br/docs/new-page.md
Created page: ./content/de/docs/new-page.md
Created page: ./content/ko/docs/new-page.md
Created page: ./content/id/docs/new-page.md
Created page: ./content/fr/docs/new-page.md
Created page: ./content/es/docs/new-page.md
Created page: ./content/en/docs/new-page.md