Updating and internationalizing documentation
- FDR
- Offline
Please Log in or Create an account to join the conversation.
- FDR
- Offline
...and the beautiful logo has gone from the cover!
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please note I haven't done anything to the style files, so this is a pretty basic Sphinx look, which we can still adapt to our liking. And you will get your logo back if you want to
Translations will still be pulled from the same transifex project, we will only need to add a token for transifex to the DeviationTX travis settings. So if you want to you can continue work, but honestly I'd suggest we wait with translations (except some test ones I'll also do to test the multi language output) until we are in main repo in case something gets messed up (but which I think is pretty unlikely as it is already working pretty solid).
edit: the logo is back
Please Log in or Create an account to join the conversation.
- FDR
- Offline
I.e. when a translation is done, change something in the original, and how that will reflected in transifex.
The same for small changes and larger overhauls...
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Furthermore, we can start translating the manual even before we can actually compile them...
On the other side, we need to change the build process, so in the end there were a few PDFs with the language postfixes, which can be uploaded automatically.
Also we need to build the HTML documentation too, which should end in a zip file with all the contents. Then I have to make an upload procedure for that too.
Finally somebody can start to refine the document format as well, but that has the least priority IMO.
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
I will recheck everything, clean up the Makefile including zipping html directory (is that how you upload it to DeviationTX or could we also directly upload html manual?) and make a pull request.
Please Log in or Create an account to join the conversation.
- FDR
- Offline
It's easier and faster, then uploading a lot of files into a few different directories...
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
In HTML builds, after make html-release the files en.zip, fr.zip etc. Are found in html-devo8 (or 10), each zip contains the subdirectory html-devo8-en and so on.
For PDF, after make latexpdf-release, devo8manual_en.pdf and all others can be found in pdf-devo8.
We can change the output process in Makefile if you prefer something else for the upload script.
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Do we need translated HTML versions at all?
I thought we will have them only in english, like it is today...
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please Log in or Create an account to join the conversation.
- FDR
- Offline
I don't see why would somebody prefer to download the zipped html help over the PDFs...
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Please Log in or Create an account to join the conversation.
- Moeder
- Topic Author
- Offline
- Posts: 796
edit: the files size differences between old and new pdfs are amazing...
Please Log in or Create an account to join the conversation.
- FDR
- Offline
Won't storing back the translations into GitHub during the build cause an infinite loop?
Please Log in or Create an account to join the conversation.
- Home
- Forum
- Development
- Development
- Updating and internationalizing documentation