Translate the one-page tutorial in your language!

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

[Mridulbirla13]

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

[Lucas-C]

Awesome! Thank you @Mridulbirla13 😊

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

[Tititesouris]

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

[Lucas-C]

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

[digidigital]

I can provide a German translation.

[Lucas-C]

Great! Go ahead 😉

[Tititesouris]

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]

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

[yellkrishna]

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.

[Lucas-C]

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

[bcronald]

Hi! I want to translate in Tamil please.

[Lucas-C]

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]

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

[bcronald]

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]

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]

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]

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]

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.

[sokratisvas]

Hi, I can provide a Greek translation.

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

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]

Hey! I would love to work on Turkish translation.

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

[Lucas-C]

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

We would still welcome new translations though!

[Bubbu0129]

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

[Lucas-C]

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]

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]

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

[Lucas-C]

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:

• Deutsch
• español
• हिंदी
• português
• Русский
• Italian
• Ελληνικά
• עברית
• 简体中文

[kuth-chi]

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?

[Lucas-C]

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]

Thank you ,

[gmischler]

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

[TzviGreenfeld]

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

[gmischler]

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]

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]

Leave the Dutch to me.

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