Turkish APA-7 and TR Dizin Style
Applies Turkish academic-writing conventions to a manuscript: the TR Dizin
(TUBITAK ULAKBIM's national citation index — Türkiye'nin ulusal atıf dizini)
manuscript-formatting rules, and the Türkçe APA 7 (the Turkish-language
adaptation of APA 7th edition) for in-text citations and the reference list.
This is the style/formatting skill for the Turkish track — it does not check
whether a journal is actually indexed (that is alterlab-trdizin), and it is
distinct from the English citation skills.
It exists because the suite's other writing skills (alterlab-citation-mgmt,
alterlab-venue-templates, alterlab-paper-writer) target English-language
APA/IEEE/Vancouver output. Turkish journals impose their own bilingual
öz (abstract) requirements and a citation dialect with Turkish
abbreviations (ve ark., vd., s., Çev., t.y., aktaran) that those
skills do not produce.
When to Use This Skill
Use this skill when the request is about writing/formatting a Turkish
manuscript or its citations:
- "Bu makaleyi TR Dizin formatına göre düzenle" — format a manuscript to TR Dizin rules.
- "Türkçe APA 7'ye göre kaynakça/atıf düzelt" — fix references / in-text cites to Turkish APA 7.
- Writing a bilingual öz + abstract pair (Turkish öz and Latin-script English abstract).
- Deciding whether to write ve ark. or vd., where the & ampersand is allowed, how to write s./ss., Çev., t.y., or aktaran.
- Checking a Turkish journal manuscript against TR Dizin's structural requirements before submission.
Does NOT Trigger
Route adjacent requests to the correct sibling skill:
| The user wants… |
Route to |
| English-language APA/Vancouver/IEEE citations or a reference manager workflow |
alterlab-citation-mgmt |
| A journal- or publisher-specific submission template (English venues) |
alterlab-venue-templates |
| Whether a journal is currently indexed in TR Dizin (live status) |
alterlab-trdizin |
| Find/harvest articles or metadata from a DergiPark-hosted journal |
alterlab-dergipark |
| Search/cite a Turkish graduate thesis (YÖK Ulusal Tez Merkezi) |
alterlab-yok-tez |
| Write or scaffold the whole paper (IMRaD, structure, drafting) |
alterlab-paper-writer |
| Compute docentlik (associate-professorship) or akademik teşvik (academic-incentive) points |
alterlab-docentlik-eligibility / alterlab-akademik-tesvik |
| Turkish etik kurul (ethics-committee) application or KVKK data plan |
alterlab-tr-research-ethics / alterlab-kvkk-dmp |
| Verify that cited references actually exist (hallucination check) |
alterlab-citation-verifier |
This skill owns how Turkish text and citations are formatted, not whether
the underlying journal/index/claim is real.
TR Dizin manuscript requirements
TR Dizin is a citation index with editorial criteria, separate from
DergiPark hosting — hosting on DergiPark does not imply TR Dizin indexing.
Distinguish two layers and never present house conventions as index rules:
What TR Dizin itself mandates (from its official evaluation criteria):
- A word limit for the abstract must be set and enforced — TR Dizin
specifies no number, and gives no keyword count.
- Second-language metadata is suggested, not required. TR Dizin only
suggests a title/abstract/keywords in a language other than the article's.
It mandates Latin script only for non-Latin-alphabet articles (their
title/abstract/keywords/references), and requires the reference list in Latin
script.
- At least two referees per article, from different institutions
(farklı kurumlardan hakem); a manuscript should arrive review-ready.
Common Turkish-journal house conventions (widespread, but the journal's
rules — confirm against its yazım kuralları, do not attribute to TR Dizin):
- Bilingual abstract: a Turkish öz + an English abstract, each
~200-250 words — a frequent default, not a TR Dizin figure.
- Keywords: 3-5 (anahtar kelimeler) per language — a frequent default.
- Structured abstract where the field requires it (e.g. health sciences):
purpose, method, results, conclusion as labelled segments.
- Latin Turkish letters with diacritics in the metadata block (İ/ı, Ş/ş,
Ğ/ğ, Ç/ç, Ö/ö, Ü/ü), not ASCII — so the record harvests cleanly.
Full criteria detail, the verbatim TR Dizin wording, and source links live in
references/trdizin_manuscript.md. For live index status ("is journal X
in TR Dizin right now?") do not guess — defer to alterlab-trdizin.
Verify current TR Dizin criteria against the official page before a real
submission — ULAKBIM revises them periodically. Source of record:
https://trdizin.gov.tr/?p=456
Türkçe APA 7 — the deltas from English APA 7
Turkish APA 7 keeps APA's structure but swaps the connective words and
abbreviations into Turkish. The high-frequency deltas:
| Situation |
English APA 7 |
Türkçe APA 7 |
| 3+ authors, in-text |
Smith et al. |
Yılmaz ve ark. or Yılmaz vd. |
| Two authors joined, in-text (narrative) |
Smith and Jones |
Yılmaz ve Demir |
| Two authors joined, reference list / parenthetical |
Smith & Jones |
Yılmaz & Demir (& only here) |
| Page / pages |
p. / pp. |
s. / ss. |
| No date |
n.d. |
t.y. (tarih yok) |
| Translator |
Trans. |
Çev. (çeviren) |
| Editor(s) |
Ed./Eds. |
Ed./Haz. (hazırlayan) |
| Secondary / as-cited-in |
as cited in |
aktaran |
| Retrieved from |
Retrieved from |
Erişim adresi |
Key rules:
- Ampersand
& belongs only in the reference list and in parenthetical
in-text citations. In running Turkish prose use the word ve.
ve ark. vs vd. — both render "et al." Pick one and apply it
consistently across the whole manuscript (a journal may mandate one).
aktaran marks a secondary citation (you read source B citing source
A): (Yılmaz, 2018, aktaran Demir, 2021).
- Turkish capitalization & diacritics are preserved in titles and author
names — never strip İ/ı, Ş/ş, Ğ/ğ, Ç/ç, Ö/ö, Ü/ü. Sentence-case article
titles as in APA, using Turkish casing rules.
Worked in-text and reference-list examples (book, chapter, journal article,
thesis, translated work, secondary citation) are in
references/turkce_apa7.md.
Workflow
Identify the target. Confirm the journal is Turkish/Türkçe and whether
it follows TR Dizin rules and/or Türkçe APA 7. If the user actually needs an
English venue template, stop and route to alterlab-venue-templates.
Structure the metadata block. Draft or check the öz/abstract and keywords.
Propose the common house defaults (bilingual öz + abstract ~200-250 words
each, 3-5 keywords each) but tell the user these are the journal's
convention — TR Dizin itself only requires a word limit be set — so they must
confirm the figures against the journal's yazım kuralları. Keep the
metadata in proper Latin Turkish letters with diacritics. See the TR Dizin
section.
Convert citations. Rewrite in-text citations and the reference list into
Türkçe APA 7 using the delta table; preserve all diacritics.
Lint. Run the citation linter to catch the common mechanical errors
(English abbreviations left in, & used in narrative prose, mixed
ve ark./vd.):
uv run python skills/turkish-academia/alterlab-tr-academic-style/scripts/tr_apa_lint.py manuscript.md
It reads a .md/.txt/.tex file (or stdin), reports line-numbered
findings as text or --json, and is stdlib-only (no network, no deps).
Report. Present the corrected text plus the lint findings. Flag any
point where a journal's own guide may override the default (e.g. it
mandates vd. not ve ark.), and remind the user to confirm live TR Dizin
status via alterlab-trdizin before submitting.
Self-Check Before Reporting
- Did you present 200-250 words / 3-5 keywords / mandatory-bilingual as the journal's house convention (to confirm against its yazım kuralları), not as a TR Dizin index rule?
- Did you scope TR Dizin's own requirements correctly (word limit set; 2 referees from different institutions; second-language abstract suggested; Latin script mandated for non-Latin-alphabet articles)?
- Is
& confined to the reference list and parenthetical cites (never narrative prose)?
- Is
ve ark./vd. consistent throughout?
- Are all Turkish diacritics intact in names and titles?
- Did you avoid asserting a journal's TR Dizin index status from memory? (That is
alterlab-trdizin's job.)
References
references/trdizin_manuscript.md — TR Dizin manuscript-formatting criteria, the DergiPark-vs-TR-Dizin distinction, and source links.
references/turkce_apa7.md — full Türkçe APA 7 delta tables with worked in-text and reference-list examples.
Part of the AlterLab Academic Skills suite.
1---2name: alterlab-tr-academic-style3description: Formats manuscripts for Turkish journals: TR Dizin submission rules (TR Dizin mandates a set abstract word limit, two referees from different institutions, Latin script for non-Latin-alphabet articles, and only suggests a second-language abstract; bilingual oz/abstract ~200-250 words and 3-5 keywords are common journal house conventions to confirm against the journal's yazim kurallari) and the Turkish adaptation of APA-7 (ve ark./vd. for multi-author cites, ampersand only in the reference list, s. for page, Cev. for translator, t.y. for no date, aktaran for as-cited-in, Turkish capitalization). Use when writing for a Turkish/Turkce journal, preparing a TR Dizin submission, needing Turkce APA 7 in-text or reference formatting, or formatting a bilingual oz. For English-language citation styles prefer alterlab-citation-mgmt or alterlab-venue-templates; for live TR Dizin index status use alterlab-trdizin. Part of the AlterLab Academic Skills suite.4license: MIT5---67# Turkish APA-7 and TR Dizin Style89Applies Turkish academic-writing conventions to a manuscript: the **TR Dizin**10(TUBITAK ULAKBIM's national citation index — *Türkiye'nin ulusal atıf dizini*)11manuscript-formatting rules, and the **Türkçe APA 7** (the Turkish-language12adaptation of APA 7th edition) for in-text citations and the reference list.13This is the *style/formatting* skill for the Turkish track — it does not check14whether a journal is actually indexed (that is `alterlab-trdizin`), and it is15distinct from the English citation skills.1617It exists because the suite's other writing skills (`alterlab-citation-mgmt`,18`alterlab-venue-templates`, `alterlab-paper-writer`) target English-language19APA/IEEE/Vancouver output. Turkish journals impose their own bilingual20**öz** (*abstract*) requirements and a citation dialect with Turkish21abbreviations (*ve ark.*, *vd.*, *s.*, *Çev.*, *t.y.*, *aktaran*) that those22skills do not produce.2324## When to Use This Skill2526Use this skill when the request is about **writing/formatting** a Turkish27manuscript or its citations:2829- "Bu makaleyi TR Dizin formatına göre düzenle" — format a manuscript to TR Dizin rules.30- "Türkçe APA 7'ye göre kaynakça/atıf düzelt" — fix references / in-text cites to Turkish APA 7.31- Writing a bilingual **öz** + abstract pair (Turkish öz and Latin-script English abstract).32- Deciding whether to write *ve ark.* or *vd.*, where the *&* ampersand is allowed, how to write *s.*/*ss.*, *Çev.*, *t.y.*, or *aktaran*.33- Checking a Turkish journal manuscript against TR Dizin's structural requirements before submission.3435### Does NOT Trigger3637Route adjacent requests to the correct sibling skill:3839| The user wants… | Route to |40|-----------------|----------|41| English-language APA/Vancouver/IEEE citations or a reference manager workflow | `alterlab-citation-mgmt` |42| A journal- or publisher-specific submission template (English venues) | `alterlab-venue-templates` |43| Whether a journal is **currently indexed** in TR Dizin (live status) | `alterlab-trdizin` |44| Find/harvest articles or metadata from a DergiPark-hosted journal | `alterlab-dergipark` |45| Search/cite a Turkish graduate thesis (YÖK Ulusal Tez Merkezi) | `alterlab-yok-tez` |46| Write or scaffold the whole paper (IMRaD, structure, drafting) | `alterlab-paper-writer` |47| Compute docentlik (*associate-professorship*) or akademik teşvik (*academic-incentive*) points | `alterlab-docentlik-eligibility` / `alterlab-akademik-tesvik` |48| Turkish etik kurul (*ethics-committee*) application or KVKK data plan | `alterlab-tr-research-ethics` / `alterlab-kvkk-dmp` |49| Verify that cited references actually exist (hallucination check) | `alterlab-citation-verifier` |5051This skill owns **how Turkish text and citations are formatted**, not whether52the underlying journal/index/claim is real.5354## TR Dizin manuscript requirements5556TR Dizin is a **citation index with editorial criteria**, separate from57DergiPark hosting — hosting on DergiPark does not imply TR Dizin indexing.58**Distinguish two layers** and never present house conventions as index rules:5960**What TR Dizin itself mandates** (from its official evaluation criteria):6162- **A word limit for the abstract** must be set and enforced — TR Dizin63 specifies **no** number, and gives **no** keyword count.64- **Second-language metadata is *suggested*, not required.** TR Dizin only65 *suggests* a title/abstract/keywords in a language other than the article's.66 It *mandates* Latin script only for **non-Latin-alphabet articles** (their67 title/abstract/keywords/references), and requires the reference list in Latin68 script.69- **At least two referees per article, from different institutions**70 (*farklı kurumlardan hakem*); a manuscript should arrive review-ready.7172**Common Turkish-journal house conventions** (widespread, but the *journal's*73rules — confirm against its *yazım kuralları*, do not attribute to TR Dizin):7475- **Bilingual abstract:** a Turkish **öz** + an English **abstract**, each76 **~200-250 words** — a frequent default, not a TR Dizin figure.77- **Keywords:** **3-5** (*anahtar kelimeler*) per language — a frequent default.78- **Structured abstract** where the field requires it (e.g. health sciences):79 purpose, method, results, conclusion as labelled segments.80- **Latin Turkish letters with diacritics** in the metadata block (İ/ı, Ş/ş,81 Ğ/ğ, Ç/ç, Ö/ö, Ü/ü), not ASCII — so the record harvests cleanly.8283Full criteria detail, the verbatim TR Dizin wording, and source links live in84`references/trdizin_manuscript.md`. For **live index status** ("is journal X85in TR Dizin right now?") do not guess — defer to `alterlab-trdizin`.8687> Verify current TR Dizin criteria against the official page before a real88> submission — ULAKBIM revises them periodically. Source of record:89> https://trdizin.gov.tr/?p=4569091## Türkçe APA 7 — the deltas from English APA 79293Turkish APA 7 keeps APA's structure but swaps the connective words and94abbreviations into Turkish. The high-frequency deltas:9596| Situation | English APA 7 | Türkçe APA 7 |97|-----------|---------------|--------------|98| 3+ authors, in-text | Smith et al. | Yılmaz ve ark. **or** Yılmaz vd. |99| Two authors joined, **in-text (narrative)** | Smith and Jones | Yılmaz ve Demir |100| Two authors joined, **reference list / parenthetical** | Smith & Jones | Yılmaz & Demir (`&` only here) |101| Page / pages | p. / pp. | s. / ss. |102| No date | n.d. | t.y. (*tarih yok*) |103| Translator | Trans. | Çev. (*çeviren*) |104| Editor(s) | Ed./Eds. | Ed./Haz. (*hazırlayan*) |105| Secondary / as-cited-in | as cited in | aktaran |106| Retrieved from | Retrieved from | Erişim adresi |107108Key rules:1091101. **Ampersand `&` belongs only in the reference list and in *parenthetical*111 in-text citations.** In running Turkish prose use the word **ve**.1122. **`ve ark.` vs `vd.`** — both render "et al." Pick one and apply it113 consistently across the whole manuscript (a journal may mandate one).1143. **`aktaran`** marks a secondary citation (you read source B citing source115 A): `(Yılmaz, 2018, aktaran Demir, 2021)`.1164. **Turkish capitalization & diacritics** are preserved in titles and author117 names — never strip İ/ı, Ş/ş, Ğ/ğ, Ç/ç, Ö/ö, Ü/ü. Sentence-case article118 titles as in APA, using Turkish casing rules.119120Worked in-text and reference-list examples (book, chapter, journal article,121thesis, translated work, secondary citation) are in122`references/turkce_apa7.md`.123124## Workflow1251261. **Identify the target.** Confirm the journal is Turkish/Türkçe and whether127 it follows TR Dizin rules and/or Türkçe APA 7. If the user actually needs an128 English venue template, stop and route to `alterlab-venue-templates`.1292. **Structure the metadata block.** Draft or check the öz/abstract and keywords.130 Propose the common house defaults (bilingual öz + abstract ~200-250 words131 each, 3-5 keywords each) but tell the user these are the *journal's*132 convention — TR Dizin itself only requires a word limit be set — so they must133 confirm the figures against the journal's *yazım kuralları*. Keep the134 metadata in proper Latin Turkish letters with diacritics. See the TR Dizin135 section.1363. **Convert citations.** Rewrite in-text citations and the reference list into137 Türkçe APA 7 using the delta table; preserve all diacritics.1384. **Lint.** Run the citation linter to catch the common mechanical errors139 (English abbreviations left in, `&` used in narrative prose, mixed140 `ve ark.`/`vd.`):141142 ```bash143 uv run python skills/turkish-academia/alterlab-tr-academic-style/scripts/tr_apa_lint.py manuscript.md144 ```145146 It reads a `.md`/`.txt`/`.tex` file (or stdin), reports line-numbered147 findings as text or `--json`, and is stdlib-only (no network, no deps).1485. **Report.** Present the corrected text plus the lint findings. Flag any149 point where a journal's own guide may override the default (e.g. it150 mandates `vd.` not `ve ark.`), and remind the user to confirm live TR Dizin151 status via `alterlab-trdizin` before submitting.152153## Self-Check Before Reporting154155- Did you present 200-250 words / 3-5 keywords / mandatory-bilingual as the journal's house convention (to confirm against its *yazım kuralları*), not as a TR Dizin index rule?156- Did you scope TR Dizin's own requirements correctly (word limit set; 2 referees from different institutions; second-language abstract *suggested*; Latin script mandated for non-Latin-alphabet articles)?157- Is `&` confined to the reference list and parenthetical cites (never narrative prose)?158- Is `ve ark.`/`vd.` consistent throughout?159- Are all Turkish diacritics intact in names and titles?160- Did you avoid asserting a journal's TR Dizin index status from memory? (That is `alterlab-trdizin`'s job.)161162## References163164- `references/trdizin_manuscript.md` — TR Dizin manuscript-formatting criteria, the DergiPark-vs-TR-Dizin distinction, and source links.165- `references/turkce_apa7.md` — full Türkçe APA 7 delta tables with worked in-text and reference-list examples.166167Part of the AlterLab Academic Skills suite.