Comments (2)
Gave this a try but this is not quite ready to use yet. The helper only allows building the book for a single language at a time, and doesnt include a language selector. So we should wait until those things are added before migrating.
from lemmy-docs.
Hi all, thanks for trying out mdbook-i18n-helpers!
The helper only allows building the book for a single language at a time,
This is a bit of a feature — instead of trying to hack on mdbook
to teach it about the translations, we simply generate the translations one-by-one. We have ~18 translations for Comprehensive Rust 🦀 and this system works quite well for us.
One advantage of this: it's clear that the built-in mdbook
search functionality is per-language. If I had somehow added all the translated Markdown files into a single src/
folder, then I would have had to do something to avoid having the search index cover all languages simultaneously 🙂
and doesnt include a language selector. So we should wait until those things are added before migrating.
You're right and I would like to package up a language selector! However, for now, we simply edit the theme/index.hbs
as needed. Out of the 18 translations, only two are at a stage where we link them directly in the language selector (see the globe in the top-right of any published page).
Please open issues for any problems you run into if you try it out again. It's important for me that the plugins work in general and not just in my own special case 🙂
from lemmy-docs.
Related Issues (20)
- [Request] Podman Install HOT 3
- Add sources to back up "History of Lemmy"
- [Bug]: embed pictrs doesn't work HOT 1
- administration/configuration.html has a faulty link to 'defaults.hjson'
- Contributor local development postgreSQL missing a step HOT 1
- Theming section is outdated
- The client contributer example for Rust is wrong HOT 1
- Document that high db pool size requires increased shared memory for postgres HOT 4
- Suggested backup script is somewhat dangerous HOT 3
- Lemmy migration from a domain name to another HOT 2
- `docker-compose.yml` linked for manual docker install contain ansible if-statements HOT 6
- Introducing Elestio as one-click deployment option with others
- [Bug]: yaml: line 32: found character that cannot start any token HOT 4
- Json Objects in the doc are not loaded in correctly HOT 3
- [Bug]: Incorrect pathing in copy binary command in "from scratch" doc HOT 3
- Object Storage for embedded pict-rs on from scratch install? HOT 7
- Missing pg_format install instructions
- Document how to delete images (pict-rs) HOT 4
- `pnpm translations:generate` is missing in lemmy-ui local development instructions HOT 1
- Dependency Dashboard
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from lemmy-docs.