Translate the one-page tutorial in your language!

Question

Translate the one-page tutorial in your language!

Lucas-C opened this issue 3 years ago · 44 comments

Lucas-C commented 3 years ago

The tutorial is a simple Markdown document:

rendered as HTML: https://pyfpdf.github.io/fpdf2/Tutorial.html
source: https://github.com/PyFPDF/fpdf2/blob/master/docs/Tutorial.md

It is currently available in several languages, listed in the README and the documentation index page.

PRs are very welcome to add new translations!
PR authors will be added to the contributors list & map.

Guidelines:

open a Pull Request that creates or modifies the corresponding docs/Tutorial-xy.md file, taking inspiration from docs/Tutorial.md (where xy is the ISO_639-1 language code)
if you created a new file, add a reference to it in docs/index.md, mkdocs.yml, README.md and CHANGELOG.md, taking inspiration from the references to existing translated tutorials

Answer 1 · 2021-10-26T06:24:35.000Z

Hey, I want to work on this issue. I will translate this tutorial in Hindi(हिंदी)

Answer 2 · 2021-10-26T07:24:03.000Z

Awesome! Thank you @Mridulbirla13 😊

If you need any help, on fpdf2 or how to submit a PR, ask you your questions here!

Answer 3 · 2021-10-26T14:48:59.000Z

Hi, I can take care of the French translation if you want :)

Answer 4 · 2021-10-26T14:54:43.000Z

@Tititesouris : chouette !
Je procrastine à faire la trad depuis des mois ^^
Avec plaisir !

Answer 5 · 2021-10-26T23:42:00.000Z

I can provide a German translation.

Answer 6 · 2021-10-27T07:36:14.000Z

Great! Go ahead 😉

Answer 7 · 2021-10-27T21:25:34.000Z

Hey @Lucas-C, vu la quantité de travail, mon temps limité et le fait que Hacktoberfest arrive bientôt à son terme, est-ce que ça te dérange si je te fais une première PR avec le tuto 1 (tu peux du coup déjà me faire un retour sur la qualité), et une autre PR d'ici le 30 avec au moins les tutos 2 & 3 ?
Dans tous les cas je te traduis l'entièreté d'ici la mi-novembre 😉

Answer 8 · 2021-10-28T05:54:37.000Z

Aucun problème, fais ça au rythme que tu veux !

Answer 9 · 2021-12-07T06:44:38.000Z

The tutorial is a simple Markdown document:

rendered as HTML: https://pyfpdf.github.io/fpdf2/Tutorial.html

source: https://github.com/PyFPDF/fpdf2/blob/master/docs/Tutorial.md

It is currently available in English, Français, Deutsch, Hindi, Italian, Portugese, Russian & Spanish.

PRs are very welcome to add new translations!

Hey! I can provide a Telugu translation for this.

Answer 10 · 2021-12-07T08:39:48.000Z

@yellkrishna That would be wonderful!
Thank you for volunteering 🙏❤️

Answer 11 · 2022-04-18T17:07:20.000Z

Hi! I want to translate in Tamil please.

Answer 12 · 2022-04-18T21:12:41.000Z

Hi and welcome @bcronald !
That would be great 😊
Do you need guidance on how to proceed, or do you already know how to submit a PR?

Answer 13 · 2022-04-18T21:15:37.000Z

By the way @yellkrishna & @bcronald: have you checked that fpdf2 can render text in those languages?
I'm curious because we have already faced limitations with Hindi: #365

Answer 14 · 2022-04-21T11:33:33.000Z

Hi and welcome @bcronald ! That would be great blush Do you need guidance on how to proceed, or do you already know how to submit a PR?

Thanks. Yes please, guidance would be nice. Sorry for the late reply.

Answer 15 · 2022-04-21T11:35:00.000Z

By the way @yellkrishna & @bcronald: have you checked that fpdf2 can render text in those languages? I'm curious because we have already faced limitations with Hindi: #365

No, not yet checked in Tamil. I will do that and post result.

Answer 16 · 2022-04-21T16:53:13.000Z

By the way @yellkrishna & @bcronald: have you checked that fpdf2 can render text in those languages? I'm curious because we have already faced limitations with Hindi: #365

No, not yet checked in Tamil. I will do that and post result.

Tamil is not being rendered correctly.

Code:
from fpdf import FPDF

pdf = FPDF()
pdf.add_page()
pdf.add_font('lohit-taml', fname='/usr/share/fonts/truetype/lohit-tamil/Lohit-Tamil.ttf')
pdf.set_font('lohit-taml', size=18)
pdf.write(8, u'யாதும் ஊரே யாவரும் கேளிர்')
pdf.output("fpdf2_tamil_test.pdf")

Attached the resulting pdf below:
fpdf2_tamil_test.pdf
்

Answer 17 · 2022-04-21T19:04:51.000Z

Tamil is not being rendered correctly.

It's a pity 😔 Thanks for testing @bcronald.
I don't know Tamil: is the problem with ligatures, like for Hindi text, or is there a different issue here?

Answer 18 · 2022-04-23T13:57:08.000Z

is the problem with ligatures, like for Hindi text, or is there a different issue here?

Yes, it is the same problem as here global-healthy-liveable-cities/global_scorecards#7
When the text is selected and copied from the pdf and pasted into text editor (I am on Ubuntu 20.04) it apperars correctly, wheras in the pdf, the components of a complex character are either not arranged in the correct sequence or not attached together with main character.

Answer 19 · 2022-08-09T09:42:40.000Z

Hi, I can provide a Greek translation.

Answer 20 · 2022-08-09T09:51:02.000Z

Hi and welcome @bcronald ! That would be great blush Do you need guidance on how to proceed, or do you already know how to submit a PR?

Thanks. Yes please, guidance would be nice. Sorry for the late reply.

I suggest to read the following documentation on how to submit a contribution:
https://opensource.guide/how-to-contribute/#how-to-submit-a-contribution

Once you will be familiar with the basic concepts of git & GitHub,
you can copy the file docs/Tutorial.md in a file docs/Tutorial-ta.md and perform the translation. Then submit a Pull Request containing this file.

Hi, I can provide a Greek translation.

That would be awesome @sokratisvas , great!

Do you need any more information or guidance?

Answer 21 · 2022-09-30T05:52:37.000Z

Hi
I can provide Urdu Translation :)

Answer 22 · 2022-10-03T08:06:37.000Z

Hi and welcome @Dani-Google!

That would be awesome 😊

You are very welcome to submit a Pull Request of a new docs/Tutorial-urd.md file!

Answer 23 · 2022-10-03T08:46:27.000Z

Ok, thanks :)

Answer 24 · 2022-10-03T12:58:33.000Z

@Lucas-C Hi there, I can try a Kannada language translation, will check if its rendered properly. Is that okay?

Answer 25 · 2022-10-03T13:00:37.000Z

@Lucas-C Hi there, I can try a Kannada language translation, will check if its rendered properly. Is that okay?

That is more than OK, you are very welcome to do so @SmritiSatyan! 😊

Answer 26 · 2022-10-05T11:12:46.000Z

Hi, I can start working on hebrew translation

Answer 27 · 2022-10-05T11:15:52.000Z

Hi, I can start working on hebrew translation

That would be great, thank you @TzviGreenfeld 😊

Answer 28 · 2022-10-11T20:28:55.000Z

Hey there! I want to finish the French translation.

Answer 29 · 2022-10-22T12:23:49.000Z

Hey! I would love to work on Turkish translation.

Answer 30 · 2022-10-23T08:27:16.000Z

Hey! I would love to work on Turkish translation.

Nice! Go on, you are very welcome do do so @ethmtrgt 😊

Answer 31 · 2022-12-29T12:16:53.000Z

Re-opening this: I just now realize that I closed the issue in October 🤭😅

We would still welcome new translations though!

Answer 32 · 2023-01-14T15:17:00.000Z

Need Simplified Chinese translation? I think I can get the main parts translated, but maybe not every page of the doc.

Answer 33 · 2023-01-14T15:57:33.000Z

Yes, such translation of the tutorial would be welcome @Bubbu0129!

Even if you only translate one or two of the 6 sections of the tutorial, a PR would be welcome as a starting point!

Answer 34 · 2023-03-13T18:14:57.000Z

Hello, @Lucas-C I would like to work on Bengali Translation. Can I do that?
If yes then a Quick Question - I need to translate this Tutorial.md file. Am I right?

Answer 35 · 2023-03-13T18:50:13.000Z

Hello, @Lucas-C I would like to work on Bengali Translation. Can I do that?

Wonderful! Yes, please do so!

then a Quick Question - I need to translate this Tutorial.md file. Am I right?

Exactly 😊
You can take inspiration from the previous PRs,
like this one that introduced a Russian translation: #283

Answer 36 · 2023-03-27T15:56:04.000Z

Note to all translators: with the introduction of the new FPDF.table() method,
the section 5 of the tutorial is now obsolote and was removed from all tutorials.

Contributions are welcome to translate the new section 5 (https://pyfpdf.github.io/fpdf2/Tutorial.html#tuto-5-creating-tables) from English to one of those languages:

Answer 37 · 2023-06-02T09:00:35.000Z

The tutorial is a simple Markdown document:

rendered as HTML: https://pyfpdf.github.io/fpdf2/Tutorial.html

source: https://github.com/PyFPDF/fpdf2/blob/master/docs/Tutorial.md

It is currently available in several languages, listed in the README and the documentation index page.

PRs are very welcome to add new translations! PR authors will be added to the contributors list & map.

Guidelines:

open a Pull Request that creates or modifies the corresponding docs/Tutorial-xy.md file, taking inspiration from docs/Tutorial.md (where xy is the ISO_639-1 language code)

if you created a new file, add a reference to it in docs/index.md, mkdocs.yml, README.md and CHANGELOG.md, taking inspiration from the references to existing translated tutorials

I have committed a file in FPDF/docs/Tutorial.km.md is Khmer language tutorial, but today still unavailable . How to check next flow?

Answer 38 · 2023-06-02T15:39:25.000Z

I have committed a file in FPDF/docs/Tutorial.km.md is Khmer language tutorial, but today still unavailable . How to check next flow?

Hi @kuth-chi!

I see that you have added a commit on branch patch-1 of your fork there:
https://github.com/kuth-chi/fpdf2/tree/patch-1

What you need now is to open a Pull Request againt this repository, https://github.com/PyFPDF/fpdf2,
so that I can then review your contribution, and merge it.

This guide explains how to submit a Pull Request in details: https://opensource.guide/how-to-contribute/#opening-a-pull-request

Answer 39 · 2023-06-02T18:23:51.000Z

Thank you ,

Answer 40 · 2023-10-23T09:44:08.000Z

Note to all translators:

With the introduction of the new FPDF.text_columns() method, the section 4 of the tutorial is now obsolote and was removed from all tutorials without an updated translation.
In some languages, section 5 "Tables" (https://pyfpdf.github.io/fpdf2/Tutorial.html#tuto-5-creating-tables) also hasn't been updated yet.

Contributions are welcome to translate the new sections 4 and 5 from English or German to one of those languages:
Calling out to previous translators of each language! (Anyone else is of course also invited.)

español @jmunoz94
- Columns
- Tables
français @Lucas-C @Tititesouris
- Columns
Ελληνικά @sokratisvas
- Columns
- Tables
Italian @xit4
- Columns
- Tables
ខ្មែរ @kuth-chi
- Columns
português @AssuncaoAndre
- Columns
- Tables
Русский @AABur
- Columns
- Tables
हिंदी @Mridulbirla13
- Columns
- Tables
বাংলা @ssavi-ict
- Columns
עברית @TzviGreenfeld
- Columns
- Tables
简体中文 @Bubbu0129
- Columns
- Tables
日本語 @alcnaka
- Columns

Answer 41 · 2023-10-23T10:26:03.000Z

hey @gmischler, I've updated the Hebrew tutorial at #978.
just not sure if this requires a changelog update or anything else. let me know please

Answer 42 · 2023-10-23T10:43:33.000Z

hey @gmischler, I've updated the Hebrew tutorial at #978.
just not sure if this requires a changelog update or anything else. let me know please

Cool, thanks!
I only see changelog entries for full new tutorial translations, so I guess it's not required here...

Answer 43 · 2023-12-05T11:38:32.000Z

Leave the Dutch to me. Not that they need it as Dutch IT dudes English is more than sufficient! But this will be only my second contribution ever, so it's a nice starter for using git. It will also help improve my Dutch which i am learning. Don't worry i will have a native speaker cast an eye over it before i publish

Answer 44 · 2023-12-05T12:23:25.000Z

Leave the Dutch to me.

Thanks for the offer, @Polderrider!
Just go right ahead and create a PR.