search

py-pdf / fpdf2

Simple PDF generation for Python
https://py-pdf.github.io/fpdf2/
GNU Lesser General Public License v3.0
1.11k stars 251 forks source link

Translate the one-page tutorial in your language! #267

Open Lucas-C opened 3 years ago

Lucas-C commented 3 years ago

The tutorial is a simple Markdown document:

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:

Mridulbirla13 commented 3 years ago

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

Lucas-C commented 3 years ago

Awesome! Thank you @Mridulbirla13 😊

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

Tititesouris commented 3 years ago

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

Lucas-C commented 3 years ago

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

digidigital commented 3 years ago

I can provide a German translation.

Lucas-C commented 3 years ago

Great! Go ahead 😉

Tititesouris commented 3 years ago

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 😉

Lucas-C commented 3 years ago

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

yellkrishna commented 2 years ago

The tutorial is a simple Markdown document:

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.

Lucas-C commented 2 years ago

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

bcronald commented 2 years ago

Hi! I want to translate in Tamil please.

Lucas-C commented 2 years ago

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 commented 2 years ago

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

bcronald commented 2 years ago

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 commented 2 years ago

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 commented 2 years ago

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 ்

Lucas-C commented 2 years ago

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?

bcronald commented 2 years ago

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.

sokratisvas commented 2 years ago

Hi, I can provide a Greek translation.

Lucas-C commented 2 years ago

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?

Dani-Google commented 2 years ago

Hi I can provide Urdu Translation :)

Lucas-C commented 2 years ago

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!

Dani-Google commented 2 years ago

Ok, thanks :)

SmritiSatyan commented 2 years ago

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

Lucas-C commented 2 years ago

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

TzviGreenfeld commented 2 years ago

Hi, I can start working on hebrew translation

Lucas-C commented 2 years ago

Hi, I can start working on hebrew translation

That would be great, thank you @TzviGreenfeld 😊

Zenigata commented 2 years ago

Hey there! I want to finish the French translation.

ethmtrgt commented 2 years ago

Hey! I would love to work on Turkish translation.

Lucas-C commented 2 years ago

Hey! I would love to work on Turkish translation.

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

Lucas-C commented 1 year ago

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

We would still welcome new translations though!

Bubbu0129 commented 1 year ago

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

Lucas-C commented 1 year ago

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!

ssavi-ict commented 1 year ago

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?

Lucas-C commented 1 year ago

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

Lucas-C commented 1 year ago

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:

kuth-chi commented 1 year ago

The tutorial is a simple Markdown document:

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?

Lucas-C commented 1 year ago

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

kuth-chi commented 1 year ago

Thank you ,

gmischler commented 1 year ago

Note to all translators:

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.)

TzviGreenfeld commented 1 year ago

hey @gmischler, I've updated the Hebrew tutorial at https://github.com/py-pdf/fpdf2/pull/978. just not sure if this requires a changelog update or anything else. let me know please

gmischler commented 1 year ago

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...

Polderrider commented 11 months ago

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

gmischler commented 11 months ago

Leave the Dutch to me.

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