slavonic.github.io

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

slavonic.github.io

★ 9 Open GitHub ↗

sci.ponomar.net

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# slavonic.github.io

Source of `sci.ponomar.net` website.

You can check live version of this site at https://slavonic.github.io

## How to add a page

1. create a new Markdown or HTML page. Give the file a descriptive name. For example, `thoughts.md`
2. add YAML header like this:
   ```
   ---
   layout: default
   ref: thoughts
   lang: en
   ---
   
   My valuable thoughts
   ```
3. Note that you can yse any valid layout template for this new file, not necessarily a `default` one
4. Note that you must supply a unique `ref` value. Best convention is to use the file name without extension
5. Note that you must specify `lang`. Always create `lang: en` page first, because `en` is the default language of this
   site

Now, lets add a translation to `ru`

1. create a file in `/ru/` directory named `thoughts.md`
2. add YAML header like this:
   ```
   ---
   layout: default
   ref: thoughts
   lang: ru
   ---
   
   Мои умные мысли
   ```
3. Again, note that you are not restricted to the `default` layout template. But you better use the same layout
   as in English version of this page
4. Note that `ref` value must be exactly the same as in the English page
5. Note that lang is declared to be `ru`

## Conventions

1. Place translations under top-level directory with the language name
2. Mirror website tree in each language directory
3. Use `ref` as file name base. Name of translated page file is the same as the name of the English file. 
   The only difference is that translated page resides under its language directory tree

## Navigational and other site-wide information

Information global to the site (title, authors, keywords) is stored in `_config.yaml`. It is used in templates and content
by utilizing Liquid templating language. For example, `authors` data from `_config.yaml` is used in `legal.md` like this:

```
{{ site.authors[page.lang] }}
```

Note that navigational and global information has to be provided for all supported languages (unlike content pages
that may skip a language if needed). This is because this information may be used from any page and is often used by
templates (meaning that every page embeds this data).

Information that is specific to the site navigation bar is in `_data/nav.yaml`.

Footer data is specified in `_data/footer_left.yaml` and `_data/footer_right.yaml`.

slavonic.github.io

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README