docs: sync Turkish tutorial with the English version

[ihsandeniz]

What

Sync docs/Tutorial-tr.md with the current English tutorial.

Why

The Turkish translation was contributed back in 2022 (#267) and has not been synced since, so it had drifted from Tutorial.md:

• Tuto 7 - Creating PDF/A Documents was missing entirely, along with its PDF/A Standards and Conformance Classes subsections — the file was 220 lines versus 267 in English.
• Tuto 4 had a translation defect: the description sentence repeated a clause within itself, and the original English line was left in place right below it.

This is the same kind of change as #1482 (Spanish) and #1684 (French), which added Tuto 7 to their respective translations.

How

• Translated the Tuto 7 section, including both subsections.
• Left the {% include "../tutorial/tuto7.py" %} directive and the :octicons-tag-24: version tag untouched.
• Rewrote the Tuto 4 description as a single correct sentence and removed the leftover English line.
• Followed the conventions already used in this file: no closing ## on headings, and localised link labels ([Sonuç PDF]).

Checklist

• mkdocs build succeeds (192 pages)
• The rendered Tutorial-tr.html now contains the same tuto7.py code block as the English and Spanish pages (enforce_compliance, PDF/A-3B, Tutorial7 all present, matching counts)
• Heading structure now matches Tutorial.md
• No CHANGELOG entry, consistent with Add Tutorial 7 to Tutorial-es.md #1482 and Translate of Tutorial 7 in French Version #1684

I asked in #267 whether the scope should cover anything else — happy to extend this PR if you would like other translation updates included.

[andersonhc]

I asked in #267 whether the scope should cover anything else — happy to extend this PR if you would like other translation updates included.

Hi @ihsandeniz

Feel free to make any improvements you feel will be valuable.

Can you please add a line in the CHANGELOG.md file commenting your fixes?

thanks

[ihsandeniz]

Thanks @andersonhc!

Done: CHANGELOG line added, under ## [2.8.9] → ### Added. I put it there rather than under Fixed because every tutorial/translation entry in the file historically lives under Added (Punjabi in 2.8.8, Ukrainian in 2.8.5, the original tuto7 entry in 2.8.3).

What else I found in Tutorial-tr.md

The Tuto 4 defect I fixed in this PR is not isolated — the same kind of damage exists elsewhere in the file:

Section	Current Turkish	Problem
Tuto 6	"…yeni yöntem write() . Burada gösterilen yeni yöntem, metni yazdırmak için…"	the sentence repeats itself and leaves a dangling . — exactly the Tuto 4 pattern
Tuto 6	"Dış bağlantı oluşturmak için bir resim kullanarak dış bağlantı oluşturduk"	clause duplicated within the sentence
Tuto 6	"İkinci sayfaya yönlendiren … ikinci sayfaya yönlendiren bir bağlantı linki"	duplicated clause, plus "bağlantı linki" = "link link"
Tuto 6	"- işaretçi konum metnin sonuna taşınır"	broken phrase, starts lowercase (EN: "The current position moves to the end of the text")
Tuto 2	"Bu, metnin sağ kenarına kadar uzanması gerektiği anlamına gelir"	mistranslation — EN says the cell extends up to the right margin of the page, not "the right edge of the text"

Structurally the file is otherwise fine: I compared it section by section against Tutorial.md and the link counts (8/8/10/3/4/9/3) and {% include %} directives match one-to-one.

My proposal: let me fix those five in this same PR — same file, same class of defect, and it keeps the Turkish review in one place. I would then extend the CHANGELOG line to mention Tuto 2 & 6 as well. If you would rather keep this PR strictly scoped to the Tuto 7 sync, I will open a separate PR instead — your call, just say which.

One unrelated data point: of the 20 tutorial translations, only 5 currently contain Tuto 7 (de, es, fr, tr, ua). The other 15 do not: bn, gr, he, hi, id, it, ja, km, nl, pa, pl, pt, ru, sl, zh. I do not speak those languages, and I do not think machine-translating them would be a good contribution — but if it is useful I can open a tracking issue listing them as a good-first-issue for native speakers.

[andersonhc]

My proposal: let me fix those five in this same PR — same file, same class of defect, and it keeps the Turkish review in one place. I would then extend the CHANGELOG line to mention Tuto 2 & 6 as well. If you would rather keep this PR strictly scoped to the Tuto 7 sync, I will open a separate PR instead — your call, just say which.

You can do it all on this PR

About the languages with missing tutorials, you can add a comment on #267

[ihsandeniz]

Thanks @andersonhc — all five are in this PR now (03086be5), and I widened the CHANGELOG line from "Tuto 4" to "Tuto 2, 4 & 6".

Tuto 2 — it is the cell that extends to the page's right margin, not the text:

was: Bu, metnin sağ kenarına kadar uzanması gerektiği anlamına gelir
now: Bu, hücrenin sayfanın sağ kenar boşluğuna kadar uzanması gerektiği anlamına gelir

Tuto 6 — four fixes:

1. write() intro — the sentence repeated itself and left a dangling . before the multi_cell() link; rewritten as a single sentence.
2. "işaretçi konum" → "Geçerli konum" — matches The current position moves to the end of the text; the old phrase was ungrammatical and started lowercase mid-list.
3. add_link() — the Turkish had invented "we added the second page" and dropped the clause describing the clickable area; restored as "link" adını verdiğimiz ... tıklanabilir bir alan.
4. image() — the "create an external link" clause was duplicated inside its own sentence.

For margin I used "kenar boşluğu", the wording already used earlier in the same file, rather than introducing a second term.

Verification: in the Tutorial-tr.html produced by mkdocs build, all seven section anchors are present and unchanged (including #ogretici-7-pdfa-belgeleri-olusturma), and none of the four broken strings survive in the output. Section-by-section link counts against Tutorial.md are still 8/8/10/3/4/9/3.

I have posted the missing-translations list on #267 as you suggested.

[andersonhc]

@allcontributors please add @ihsandeniz for translation

[allcontributors]

@andersonhc

I've put up a pull request to add @ihsandeniz! 🎉

[andersonhc]

Merged. Thank you.