https://github.com/hugo-fixit/shortcode-missing-translation
A Hugo theme component with missing-translation shortcode.
https://github.com/hugo-fixit/shortcode-missing-translation
hugo i18n shortcodes theme-component
Last synced: 11 months ago
JSON representation
A Hugo theme component with missing-translation shortcode.
- Host: GitHub
- URL: https://github.com/hugo-fixit/shortcode-missing-translation
- Owner: hugo-fixit
- License: mit
- Created: 2025-07-08T07:40:51.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-08T08:00:57.000Z (12 months ago)
- Last Synced: 2025-07-08T09:19:48.182Z (12 months ago)
- Topics: hugo, i18n, shortcodes, theme-component
- Language: HTML
- Homepage: https://fixit.lruihao.cn
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
README
shortcode-missing-translation | FixIt
Temporarily renders the translated content of the current page in the specified language when translation is missing.
简体中文 |
繁體中文 |
English |
Français |
Русский язык |
Español |
हिन्दी |
deutsch |
한국어 |
しろうと
## Requirements
Applicable to all Hugo themes.
## Install Component
The installation method is the same as [installing a theme](https://fixit.lruihao.cn/documentation/installation/). There are several ways to install, choose one, Here are two mainstream ways.
### Install as Hugo Module
First make sure that your project itself is a [Hugo module](https://gohugo.io/hugo-modules/use-modules/#initialize-a-new-module).
Then add this theme component to your `hugo.toml` configuration file:
```toml
[module]
[[module.imports]]
path = "github.com/hugo-fixit/FixIt"
[[module.imports]]
path = "github.com/hugo-fixit/shortcode-missing-translation"
```
On the first start of Hugo it will download the required files.
To update to the latest version of the module run:
```bash
hugo mod get -u
hugo mod tidy
```
### Install as Git Submodule
Clone [FixIt](https://github.com/hugo-fixit/FixIt) and this git repository into your theme folder and add it as submodules of your website directory.
```bash
git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt
git submodule add https://github.com/hugo-fixit/shortcode-missing-translation.git themes/shortcode-missing-translation
```
Next edit `hugo.toml` of your project and add this theme component to your themes:
```toml
theme = ["FixIt", "shortcode-missing-translation"]
```
## Configuration
```toml
[gitInfo]
repo = "https://github.com/hugo-fixit/docs"
branch = "main"
# the content directory path relative to the root of the repository
dir = "content"
```
## Use Shortcode
Here is an example of usage:
```markdown
{{< missing-translation >}}
```
> [!TIP]
> Please ensure that there is at least one language translation available. If there are multiple language translations, the first one will be selected by default.
Or, specify an existing translation language:
```markdown
{{< missing-translation "en" >}}
```
## References
- [Develop Theme Components | FixIt](https://fixit.lruihao.cn/contributing/components/)
- [How to Develop a Hugo Theme Component | FixIt](https://fixit.lruihao.cn/components/dev-component/)