fpdf2 icon indicating copy to clipboard operation
fpdf2 copied to clipboard

Published 20 hours ago • verified publisher icon py-pdf

Translate the one-page tutorial in your language!

Open Lucas-C opened this issue 4 years ago • 48 comments

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

Lucas-C avatar Oct 25 '21 18:10 Lucas-C

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

Mridulbirla13 avatar Oct 26 '21 06:10 Mridulbirla13

Awesome! Thank you @Mridulbirla13 😊

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

Lucas-C avatar Oct 26 '21 07:10 Lucas-C

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

Tititesouris avatar Oct 26 '21 14:10 Tititesouris

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

Lucas-C avatar Oct 26 '21 14:10 Lucas-C

I can provide a German translation.

digidigital avatar Oct 26 '21 23:10 digidigital

Great! Go ahead 😉

Lucas-C avatar Oct 27 '21 07:10 Lucas-C

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 😉

Tititesouris avatar Oct 27 '21 21:10 Tititesouris

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

Lucas-C avatar Oct 28 '21 05:10 Lucas-C

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.

yellkrishna avatar Dec 07 '21 06:12 yellkrishna

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

Lucas-C avatar Dec 07 '21 08:12 Lucas-C

Hi! I want to translate in Tamil please.

bcronald avatar Apr 18 '22 17:04 bcronald

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?

Lucas-C avatar Apr 18 '22 21:04 Lucas-C

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: https://github.com/PyFPDF/fpdf2/issues/365

Lucas-C avatar Apr 18 '22 21:04 Lucas-C

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.

bcronald avatar Apr 21 '22 11:04 bcronald

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.

bcronald avatar Apr 21 '22 11:04 bcronald

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 ்

bcronald avatar Apr 21 '22 16:04 bcronald

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?

Lucas-C avatar Apr 21 '22 19:04 Lucas-C

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

Yes, it is the same problem as here https://github.com/carlhiggs/global_scorecards/issues/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.

bcronald avatar Apr 23 '22 13:04 bcronald

Hi, I can provide a Greek translation.

sokratisvas avatar Aug 09 '22 09:08 sokratisvas

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?

Lucas-C avatar Aug 09 '22 09:08 Lucas-C

Hi I can provide Urdu Translation :)

Dani-Google avatar Sep 30 '22 05:09 Dani-Google

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!

Lucas-C avatar Oct 03 '22 08:10 Lucas-C

Ok, thanks :)

Dani-Google avatar Oct 03 '22 08:10 Dani-Google

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

SmritiSatyan avatar Oct 03 '22 12:10 SmritiSatyan

@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! 😊

Lucas-C avatar Oct 03 '22 13:10 Lucas-C

Hi, I can start working on hebrew translation

TzviGreenfeld avatar Oct 05 '22 11:10 TzviGreenfeld

Hi, I can start working on hebrew translation

That would be great, thank you @TzviGreenfeld 😊

Lucas-C avatar Oct 05 '22 11:10 Lucas-C

Hey there! I want to finish the French translation.

Zenigata avatar Oct 11 '22 20:10 Zenigata

Hey! I would love to work on Turkish translation.

ethmtrgt avatar Oct 22 '22 12:10 ethmtrgt

Hey! I would love to work on Turkish translation.

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

Lucas-C avatar Oct 23 '22 08:10 Lucas-C