Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Edit the wiki to enable multiple languages #55

Open
alexis- opened this issue Mar 25, 2020 · 5 comments
Open

Edit the wiki to enable multiple languages #55

alexis- opened this issue Mar 25, 2020 · 5 comments
Assignees
Labels
docsify Improvement to the docsify platform enhancement New feature or request

Comments

@alexis-
Copy link
Member

alexis- commented Mar 25, 2020

docsifyjs/docsify#6 "Multi-language Navbar"
docsifyjs/docsify#604 "Multi-Language Sidebar"
https://docsify.now.sh/configuration?id=fallbacklanguages "Fallback languages"

@alexis- alexis- added enhancement New feature or request docsify Improvement to the docsify platform labels Mar 25, 2020
@alexis- alexis- added this to the SMA 2.1.0 "Open-Beta" milestone Mar 25, 2020
@rajlego
Copy link
Contributor

rajlego commented Mar 27, 2020

Are we going to have all the articles on the site translated to Chinese? If so, should we make an epic for Chinese release finish?

@rajlego
Copy link
Contributor

rajlego commented Mar 27, 2020

It seems like there are a couple of ways to do this depending on where we want to put the translations.
Docsify site has translations which you can click on on the top right, if you look here you can see that they use a separate repo per language.
From the index.html, this is how they're managing using seperate repo per language:

image

Alternatively, in the issue you mentioned, some people preferred just using separate folders. Which do you guys think would be easier to manage? I get the feeling separate repos would be easier since we'd need a separate set of people managing PRs/issues there (since none of us can read Chinese) but I have no prior experience to judge from.

@alexis-
Copy link
Member Author

alexis- commented Mar 28, 2020

Are we going to have all the articles on the site translated to Chinese? If so, should we make an epic for Chinese release finish?

Ideally yes. That's a good idea.

It seems like there are a couple of ways to do this depending on where we want to put the translations.
Docsify site has translations which you can click on on the top right, if you look here you can see that they use a separate repo per language.
From the index.html, this is how they're managing using seperate repo per language:

image

Alternatively, in the issue you mentioned, some people preferred just using separate folders. Which do you guys think would be easier to manage? I get the feeling separate repos would be easier since we'd need a separate set of people managing PRs/issues there (since none of us can read Chinese) but I have no prior experience to judge from.

Both solutions have their merit, but on the long-term I agree that separate repositories would be cleaner.

If we go this way, I'll create a new organization called e.g. supermemo-doc. There are already enough repositories as it is.

When do you intend to get started with this ?

@rajlego
Copy link
Contributor

rajlego commented Mar 28, 2020

Creating another organization seems reasonable but I'm wondering if that would cause issues with epics if we need to link both documentation + SMA issue to something. Other than that I'd be in favor.

I was working on docsify setup part of the contribution document but that's on hold if we're gonna be making a script to automate it. It looks like this requires HTML which I'm not an expert in but I can try to hack something together. If it's not too complicated I might be able to do it but there's a chance it could be too hard for me and I'd have to see if a dev can help me out.

@candywal
Copy link
Contributor

candywal commented Apr 4, 2020

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docsify Improvement to the docsify platform enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

4 participants