Best way to translate new pages intended for end users of slint website?

Diantre · 12-22-2013, 10:03 PM

Hi. I'm translating slint.txt and found a very small typo:

Code:

export GROFF_ENCODING=utf8 # If all man pages you read are either in English or encoded un UTF-8

Diantre · 12-22-2013, 10:07 PM

Here's another one (also in slint.txt):

Code:

If you use the later, you will type "uname" instead of "man" in a terminal to display manual pages encoded in UTF-8.

Shouldn't that be uman instead of uname?

Diantre · 12-22-2013, 10:59 PM

Umm, sorry. Another one (also in slint.txt):

Code:

To stay tuned and benefit or new translated tools and translations in new languages

I think that should be of.

Since this thread is closed, would it be better if we use the mailing list for these matters?

Didier Spaier · 12-22-2013, 11:27 PM

Quote:

Originally Posted by Diantre

Since this thread is closed, would it be better if we use the mailing list for these matters?

Yes that would be better, thanks Diantre for the suggestion.

And thanks for your bug reports. These bugs are fixed now on the website, and updated slint.txt is uploaded on Transifex (sorry if that tentatively makes your score on slint.txt go back to 93% :-)

PS it took you 2 minutes to complete it again, that's not too slow

PPS generated page is on line now. At first I got this warning:

Code:

asciidoc: WARNING: slint.es.txt: line 31: missing style: [paradef-default]: horizontal

Replacing NOTA with NOTE line 32 avoided it (NOTE is a reserved word). IIRC the admonition icon did appear though even before correction, which puzzles me a bit.

Diantre · 12-23-2013, 01:42 AM

Quote:

Originally Posted by Didier Spaier

PPS generated page is on line now. At first I got this warning:

Code:

asciidoc: WARNING: slint.es.txt: line 31: missing style: [paradef-default]: horizontal

Replacing NOTA with NOTE line 32 avoided it (NOTE is a reserved word). IIRC the admonition icon did appear though even before correction, which puzzles me a bit.

Yes, sorry, my mistake. I didn't realize NOTE was reserved word and wrote the spanish word without thinking. I have to review asciidoc's syntax!

kooru · 12-23-2013, 03:39 AM

Hi.

minor issue for tools page:

Code:

Warning: If you prefer to translate locally, be sure to check in Transifex Download for translation (not Dowload for use)

Code:

copy pt_BR.slackware.po in directory po/ (translation in Brazilian Portugese in this example)

Code:

But to get acquainted to the few formatting instuctions

Dowload -> DowNload
Portugese -> PortugUese
instuctions -> instRuctions

Didier Spaier · 12-23-2013, 04:00 AM

@ kooru: correction made and on line, thanks.

As you live in Italy, may be Italian is your native language?

Volunteers to strengthen existing teams are still welcome

Contribute page provides information on how to to join the Slint project.

kooru · 12-23-2013, 04:11 AM

Hi Didier,

yes I'm italian.
I was just thinking to contribute but I don't know how free time I've for this.
I risk to start and never end

Didier Spaier · 12-23-2013, 04:29 AM

Quote:

Originally Posted by kooru

I risk to start and never end

So you realize that translating takes time. That's well!

But if that happens, fortunately another contributor could take over and continue what you've begun: this has already occurred in other teams. And you could begin with "small" files to figure out amount of work needed.

kooru · 12-23-2013, 04:48 AM

Ok then, I'll see what I can translate in the next days

Thanks

sycamorex · 12-23-2013, 04:53 AM

EDIT2: Nevermind: I get it now. Disregard the post below.

In package.txt:

Quote:

A Slint package is provided for each supported Slackware edition (Slackware 13.37, Slackware 14.0 and Slackware 14.1) in directory http://slint.fr/packages[packages/].

I think it needs to be:

Quote:

http://slint.fr/packages/[packages].

In my opinion, the [packages] bit is redundant. I'd leave it as ...slint.fr/packages/
That way the url would be clickable

EDIT: Seeing more instances like that (eg. with MAN_PAGES.TXT) I'm wondering if I'm missing something - is it some kind of special syntax?

Didier Spaier · 12-23-2013, 07:52 AM

Quote:

Originally Posted by sycamorex

Disregard the post below.

I won't, Marcin, and thanks for posting.

That shows that I should have provided an easy to read and simple explanation of asciidoc syntax. I will write a page on SlackDocs on this topic in a few days, before end of year if I can.

sycamorex · 12-23-2013, 07:56 AM

Quote:

Originally Posted by Didier Spaier

I won't, Marcin, and thanks for posting.

That shows that I should have provided an easy to read and simple explanation of asciidoc syntax. I will write a page on SlackDocs on this topic in a few days, before end of year if I can.

To be honest, it's all there on the slint.fr website. I just started translating without reading anything beforehand. This is a Slackware-related project and in the spirit intended people should put some effort. Not everything should be fed on a plate. LOL. Once I've read the documentation, I'm clear on what/how to do things.

Thanks

Diantre · 12-23-2013, 01:35 PM

I have a doubt with the following bit in installer.txt:

Code:

If its name is /dev/sdc for instance, type:

dd if=<filename.iso> of=/dev/sdx bs=1M

Shouldn't the example command have /dev/sdc instead of /dev/sdx? Or maybe say something like, "replace sdx with your USB device"?

Didier Spaier · 12-23-2013, 02:20 PM

@ Diantre:
Of course. Fixed, thanks.