README.md

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