Updating and internationalizing documentation

More
18 Mar 2017 18:51 #60341 by Moeder
Since we have the complete documentation in a github repository and FDR is already working on automated building in Travis, what do you think of moving things around and in the repository and set up directories for multiple languages similar to this ?
Once done, we could invite more users who are willing to work on translations of the manual (for example Morlacus offered to spent time on a French version).

Please Log in or Create an account to join the conversation.

More
18 Mar 2017 20:27 #60348 by FDR
I'm stucked with Travis.
It couldn't compile the documentation just like either of my two docker environments can't do that...

Please Log in or Create an account to join the conversation.

More
19 Mar 2017 23:18 - 20 Mar 2017 00:19 #60387 by Moeder
Travis is running really smooth, but trying to get deviation-manual build in the docker image has been driving me nuts for the last couple of hours ....


edit: somehow python in my debian VM is totally messed up. Installed a fresh Ubuntu 16.10 VM and installed pip using the official install-script get-pip.py and everything is compiling smoothly :silly:
Last edit: 20 Mar 2017 00:19 by Moeder.

Please Log in or Create an account to join the conversation.

More
23 Mar 2017 14:18 #60617 by mwm
Replied by mwm on topic Move docs into the main repository?
While you're reworking the docs, I'd like to suggest that they be moved into the source repository, though in a different directory.

The reason for this is to tweak the process of updating a release. You'd move things (like protocols) into the release branch only when the documentation is also in place so you can move it all at once. It would also make it easier to maintain proper documentation on multiple versions of the firmware.

Do not ask me questions via PM. Ask in the forums, where I'll answer if I can.

My remotely piloted vehicle ("drone") is a yacht.

Please Log in or Create an account to join the conversation.

More
26 Mar 2017 20:12 #60779 by FDR
How do you include the env/matrix variables into script parameters?

Please Log in or Create an account to join the conversation.

More
26 Mar 2017 20:23 #60781 by Moeder
I don't quite understand. Do you mean Travis. Yml? They should be accessible as shell variables ($xyz).

Please Log in or Create an account to join the conversation.

More
26 Mar 2017 20:27 #60782 by FDR
Yes, I want to include the TARGET=devoXX in the script portion of the .travis.yml, because I think it doesn't get it.
So if I change it to:
script:
    - make html pdf $TARGET
...then will it receive "TARGET=devo10" or only "devo10"?

Please Log in or Create an account to join the conversation.

More
27 Mar 2017 05:50 #60790 by Moeder
TARGET gets set correctly, Travis logs show the matrix built correctly. Your TARGET_VERSION variable is not found

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 05:38 #60835 by Moeder
I fixed the after_success part, but the decrypt of install_documentation is not working yet. I cannot solve this for you :)

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 06:08 #60836 by FDR
Yes, I know, I'm on it.
So far if I encrypt a file, and then decrypt it on my PC it can't decrypt either.
They wrote about OpenSSL, that it has problems on Windows, but I did it in the MinGW window.
Next I will try it in the docker...

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 19:29 #60869 by Moeder
I did a quick test with travis and my github fork - please read your PM

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 20:09 #60871 by FDR
I think it is not about Travis anymore.
I can't even decrypt any file which I previously encrypted with openssl, despite I use the same proper key pair...

And since I read somewhere that OpenSSL has problems on Windows, I have tried it in the MinGW window, in the docker shell, and even on Google Could Platform with the same result, so I think I must be doing something wrong.
I have even tried with a magic word instead of the key pair (actually key + iv)...

I will try some other encryptions, or sooner or later I should read the openssl documentation... ;)

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 20:11 #60872 by Moeder
You don't need to use openssl by hand, the travis command line interface does it all for you! See my private message.

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 20:41 #60875 by FDR
F..K!!!!@&ßä*-%"+!! :evil: :evil: :evil: :evil: :evil: :evil: :evil:

I've found the mistake I made as soon as I wrote it down to you to try!
So, I think I'm back on track again...

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 20:56 #60876 by Moeder
:lol:
Ok, small option - big meaning ;)

We'll figure out the rest eventually...

Please Log in or Create an account to join the conversation.

More
28 Mar 2017 21:13 #60878 by FDR
Yes, and I copied and copied and copied again and again... :blush:

So now it decrypts well, but don't expect too much, because it is only a first test.
Only the PDFs are uploaded, and even those into a different directory...
While the upload was successful, the addition to the downloads has failed, probably because there are already existing downloads with the same name...

I will continue tomorrow.
Thanks!

Please Log in or Create an account to join the conversation.

More
29 Mar 2017 04:55 - 29 Mar 2017 04:56 #60885 by Moeder
I know how you feel ;)
Actually there is an error in the script or one of the parameters thrown to it.. Maybe some wrong parentheses again.
$ utils/upload_documentation.pl -skip -documentation build/pdf-$TARGET/$TARGET_PDF -pdf build/pdf-$TARGET/$TARGET_PDF
Unknown option: skip
/usr/bin/curl
Logging in as NightlyBuilds
Logged in
ERROR: Can't read build/pdf-devo8/echo
Last edit: 29 Mar 2017 04:56 by Moeder.

Please Log in or Create an account to join the conversation.

More
29 Mar 2017 05:46 #60887 by FDR
Nevermind the skip parameter, it doesn't have any meaning here, but of course I will correct it.
We still have proglems with the TARGET_PDF though...

Please Log in or Create an account to join the conversation.

More
29 Mar 2017 13:32 #60903 by Moeder
It seems like it is working now. Where can the manual pdf be found?

Please Log in or Create an account to join the conversation.

More
29 Mar 2017 13:47 #60904 by FDR
No, not yet, it just doesn't give errors anymore.
I've said, that it's just a first draft, which so far copies only the PDFs into a separate directory, and tries to register them into the download section, but even that hasn't yet succeeded.
It still needs quite a few modification from my part, but all the needed steps are working, at least in theory...

Please Log in or Create an account to join the conversation.

Time to create page: 0.063 seconds
Powered by Kunena Forum