Add credits and reorganize TODO
parent
43243d3e0c
commit
c833a824b6
35
README.md
35
README.md
|
@ -268,7 +268,7 @@ The current language's index page lies in {{ macros::i18n_page(path="_index.md")
|
||||||
|
|
||||||
#### Structure
|
#### Structure
|
||||||
|
|
||||||
index.html is the main template that gets rendered for everypage. It defines the current language and renders the global page skeleton accordingly. In addition, it defines a few blocks that are overriden by children templates:
|
index.html is the main template that gets rendered for everypage. It renders the global page skeleton according to the language requested. In addition, it defines a few blocks that are overriden by children templates:
|
||||||
|
|
||||||
- title: the raw page title
|
- title: the raw page title
|
||||||
- main: the main content
|
- main: the main content
|
||||||
|
@ -307,8 +307,6 @@ You can then summon this menu like this:
|
||||||
{{ widgets::menu(content="menu.md") }}
|
{{ widgets::menu(content="menu.md") }}
|
||||||
```
|
```
|
||||||
|
|
||||||
If a `lang` variable is defined in the current context, the macro will automatically find the localized page for the menu.
|
|
||||||
|
|
||||||
#### Translations in templates
|
#### Translations in templates
|
||||||
|
|
||||||
##### Localized string
|
##### Localized string
|
||||||
|
@ -319,7 +317,7 @@ If you want to use a translation string defined in the translations section of t
|
||||||
{{ trans(key="readmore", lang=lang) }}
|
{{ trans(key="readmore", lang=lang) }}
|
||||||
```
|
```
|
||||||
|
|
||||||
The lang variable is conveniently set for you at the top of index.html template so all templates which extend index.html should have it.
|
Conveniently, the `lang` variable is automatically set by Zola in most contexts.
|
||||||
|
|
||||||
##### Localized path
|
##### Localized path
|
||||||
|
|
||||||
|
@ -330,8 +328,6 @@ In case you need to interact with a localized page, you will need to replace the
|
||||||
{{ widgets::i18n_path(path="@/blog/_index.md") }}
|
{{ widgets::i18n_path(path="@/blog/_index.md") }}
|
||||||
```
|
```
|
||||||
|
|
||||||
If the `lang` variable is set in the context, the corresponding path will be returned.
|
|
||||||
|
|
||||||
##### Localized page content
|
##### Localized page content
|
||||||
|
|
||||||
If you wish to directly extract the contents of a localized page, without any regards to its frontmatter, you can use the i18n_content macro:
|
If you wish to directly extract the contents of a localized page, without any regards to its frontmatter, you can use the i18n_content macro:
|
||||||
|
@ -341,8 +337,6 @@ If you wish to directly extract the contents of a localized page, without any re
|
||||||
{{ widgets::i18n_content(path="@/blog/_index.md") }}
|
{{ widgets::i18n_content(path="@/blog/_index.md") }}
|
||||||
```
|
```
|
||||||
|
|
||||||
If the `lang` variable is set in the context, the corresponding page's content will be returned.
|
|
||||||
|
|
||||||
##### Localized URL
|
##### Localized URL
|
||||||
|
|
||||||
If you need to get the localized URI for path on the website, you can use the i18n_url macro which acts as a wrapper around the [get_url](https://www.getzola.org/documentation/templates/overview/#get-url) function:
|
If you need to get the localized URI for path on the website, you can use the i18n_url macro which acts as a wrapper around the [get_url](https://www.getzola.org/documentation/templates/overview/#get-url) function:
|
||||||
|
@ -352,8 +346,6 @@ If you need to get the localized URI for path on the website, you can use the i1
|
||||||
<a href="{{ widgets:i18n_uri(path = "rss.xml") }}">RSS</a>
|
<a href="{{ widgets:i18n_uri(path = "rss.xml") }}">RSS</a>
|
||||||
```
|
```
|
||||||
|
|
||||||
If the `lang` variable is set in the context, the corresponding URL will be returned.
|
|
||||||
|
|
||||||
# TODO
|
# TODO
|
||||||
|
|
||||||
If something is missing for you, please open an issue.
|
If something is missing for you, please open an issue.
|
||||||
|
@ -367,12 +359,23 @@ If something is missing for you, please open an issue.
|
||||||
- [x] blogposts
|
- [x] blogposts
|
||||||
- [x] other strings in the templates
|
- [x] other strings in the templates
|
||||||
- [x] localized RSS links
|
- [x] localized RSS links
|
||||||
- [ ] links to navigate between languages
|
- [x] links to navigate between languages
|
||||||
- [x] support generic default_language (not en by default)
|
- [x] support generic default_language (not en by default)
|
||||||
|
- [ ] localized title/description for RSS
|
||||||
|
- [ ] README
|
||||||
|
- [x] setup/configuration guide
|
||||||
|
- [x] contribution guide (edition, translation, webdesign)
|
||||||
|
- [x] credits
|
||||||
|
- [ ] quickstart guide for git
|
||||||
- [ ] other
|
- [ ] other
|
||||||
- [x] ASCII banner does not overflow
|
- [x] ASCII banner does not overflow
|
||||||
- [x] write setup/configuration guide
|
- [ ] translation bubble fits nicely on all sizes
|
||||||
- [x] reference water.css semantic styling
|
|
||||||
- [ ] RSS (missing localized title and description)
|
# Credits
|
||||||
- [x] hacking guides for: edition, translation, webdesign
|
|
||||||
- [ ] reference quickstart guide for git
|
This libre website would not have been possible without:
|
||||||
|
|
||||||
|
- [water.css](https://github.com/kognise/water.css) for the base stylesheet
|
||||||
|
- [Zola](https://getzola.org) static site generator (SSG)
|
||||||
|
- [Gitea](https://gitea.io) forge and [git](https://git-scm.com/) VCS
|
||||||
|
- [SASS](https://sass-lang.com/) language for our stylesheets
|
||||||
|
|
Loading…
Reference in New Issue