i18n Component

i18n, shorts for internationalization, is the component to support multi-lingual websites with language specific tools and parts. Bissetii prepared a number of CSS styled language tools for easier multi-lingual content management.

This component is available starting from v1.11.0.

Hugo

Bissetii prepared a number of Hugo interfaces to manage i18n component seamlessly across all output formats.

Shortcodes

By default, it is hard to process single or multiple card data across multiple outputs while maintaining a single input format. Hence, Bissetii prepared the following shortcodes to standardize the i18n rendering. These shortcodes are specific to Bissetii which works differently from Hugo.

translate Shortcode

To translate a given keyword to a specific language using multilingual dictionary inside the data/ directory.

1

{{< translate "[LANG_DICTONARY]" "[LANG]" "[KEYWORD]" >}}
  1. [LANG_DICTIONARY] - COMPULSORY
    1. Points to the multi-lingual dictionary dataset.
    2. It can be Hugo data pathing (e.g. lang.dictionaries).
    3. Dictionary data shall be located inside data/ directory and not Hugo’s i18n/ directory.
  2. [LANG] - COMPULSORY
    1. Selected dictionary type.
    2. To select current page’s language, use this as its value.
  3. [KEYWORD] - COMPULSORY
    1. The common keyword search for the translated value.
    2. It can be Hugo data pathing (e.g. list.section.title).

Example usage:

1
2

{{< translate "bissetii.i18n" "this" "list.Section.Description" >}}
{{< translate "bissetii.i18n" "zh-hans" "list.Section.Description" >}}

This will render as:

1
2

In case you are looking up for something in this topic, here are some of the
available content ready for you:
如果您想在这个话题里寻找一些仔细的内容，这里准备了一些简单目录让您寻找和过目：

Go

Coming Soon

HTML

Bissetii supports Button component seamlessly across multiple output formats. Additionally, starting from version v1.13.0, the use of CSS variable is vital for its upgrade from v1.12.5.

Bissetii HTML codes for this component are the same for Vanilla HTML5 and AMPHTML.

As of now, development is still investigating the requirements for this component.

CSS

Bissetii provided a list of CSS variables dedicated for Button styling alteration without needing to recompile Sass.

As of now, development is still investigating the requirements for this component.

Javascript

This component does not rely on any Javascript.

Sass

Depending on release version, the Sass files work differently. Bissetii does not package Sass codes explictly so please view them via the git repository.

As of now, development is still investigating the requirements for this component.

Researches

Here are the researches done to ensure Button component meets the necessary quality assurances:

SCHEDULED COMING SOON

Epilogue

That’s all about i18n component in Bissetii. If you need more feature or need to report a bug, please feel free to file an issue at our Issue Section.