\documentclass[a4paper,12pt]{article}

\usepackage{fontspec}
\usepackage[turkish]{babel}

% To compile in-tree (without installing): run lualatex from the project root,
% e.g.:  lualatex --output-directory=ornek ornek/ornek.tex
\usepackage{turkce-sayi}

\usepackage{booktabs}

% ── Sample document structure ──────────────────────────────────────

\title{Türkçe Sayı Ekleri — Örnek Belge}
\author{}
\date{2026}

\begin{document}
\maketitle

Bu belge \texttt{turkce-sayi} paketinin tüm komutlarını ve kurallarını
göstermek amacıyla hazırlanmıştır.

% ── Section labels for \trkpageref / \trkref tests ─────────────────

\section{Birinci Bölüm}
\label{bolum:bir}

Bu bölüm ilerleyen sayfalarda \texttt{\textbackslash trkpageref} ve
\texttt{\textbackslash trkref} komutlarıyla gönderme yapılacak referans
noktalarını içerir.

\subsection{Birinci Alt Bölüm}
\label{alt:bir}

\subsection{İkinci Alt Bölüm}
\label{alt:iki}

\section{İkinci Bölüm}
\label{bolum:iki}

\section{Üçüncü Bölüm}
\label{bolum:uc}

% ── Test table ─────────────────────────────────────────────────────
\section{Kural Testi}
\label{sec:test}

Aşağıdaki tablo her kuralı ayrı ayrı test etmektedir.
\textbf{Üretilen} sütunu paketin otomatik çıktısını,
\textbf{Beklenen} sütunu doğru biçimi gösterir.

\bigskip
\noindent
\begin{tabular}{llll}
\toprule
\textbf{Komut} & \textbf{Üretilen} & \textbf{Beklenen} & \textbf{Kural} \\
\midrule
%% Hardening (sertleşme)
\verb|\trkappend{3}{'de}|     & \trkappend{3}{'de}     & 3'te      & sertleşme \\
\verb|\trkappend{4}{'de}|     & \trkappend{4}{'de}     & 4'te      & sertleşme \\
\verb|\trkappend{40}{'de}|    & \trkappend{40}{'de}    & 40'ta     & sertleşme+arka \\
\verb|\trkappend{5}{'de}|     & \trkappend{5}{'de}     & 5'te      & sertleşme \\
\verb|\trkappend{60}{'de}|    & \trkappend{60}{'de}    & 60'ta     & sertleşme+arka \\
\midrule
%% Softening (yumuşama)
\verb|\trkappend{2}{'te}|     & \trkappend{2}{'te}     & 2'de      & yumuşama \\
\verb|\trkappend{1}{'te}|     & \trkappend{1}{'te}     & 1'de      & yumuşama \\
\verb|\trkappend{8}{'te}|     & \trkappend{8}{'te}     & 8'de      & yumuşama \\
\midrule
%% Vowel harmony — 2-way (2'li uyum)
\verb|\trkappend{6}{'de}|     & \trkappend{6}{'de}     & 6'da      & ünlü uyumu \\
\verb|\trkappend{9}{'de}|     & \trkappend{9}{'de}     & 9'da      & ünlü uyumu \\
\verb|\trkappend{80}{'de}|    & \trkappend{80}{'de}    & 80'de     & ünlü uyumu \\
\midrule
%% Vowel harmony — 4-way (4'lü uyum)
\verb|\trkappend{3}{'iniz}|   & \trkappend{3}{'iniz}   & 3'ünüz    & 4'lü uyum \\
\verb|\trkappend{9}{'iniz}|   & \trkappend{9}{'iniz}   & 9'unuz    & 4'lü uyum \\
\verb|\trkappend{6}{'iniz}|   & \trkappend{6}{'iniz}   & 6'nız     & 4'lü uyum+kaynaştırma \\
\midrule
%% Dative buffer — y (yönelme hali kaynaştırması)
\verb|\trkappend{6}{'e}|      & \trkappend{6}{'e}      & 6'ya      & y-kaynaştırma \\
\verb|\trkappend{2}{'e}|      & \trkappend{2}{'e}      & 2'ye      & y-kaynaştırma \\
\verb|\trkappend{3}{'e}|      & \trkappend{3}{'e}      & 3'e       & y yok (ünsüz son) \\
\midrule
%% Genitive buffer — n (ilgi hali kaynaştırması)
\verb|\trkappend{6}{'in}|     & \trkappend{6}{'in}     & 6'nın     & n-kaynaştırma \\
\verb|\trkappend{2}{'in}|     & \trkappend{2}{'in}     & 2'nin     & n-kaynaştırma \\
\verb|\trkappend{3}{'in}|     & \trkappend{3}{'in}     & 3'ün      & n yok (ünsüz son) \\
\midrule
%% Accusative (belirtme hali) — default y buffer
\verb|\trkappend{6}{'i}|      & \trkappend{6}{'i}      & 6'yı      & belirtme y-kayn. \\
\verb|\trkappend{2}{'i}|      & \trkappend{2}{'i}      & 2'yi      & belirtme y-kayn. \\
\midrule
%% Possessive/definite — user supplies "si"
\verb|\trkappend{6}{'si}|     & \trkappend{6}{'si}     & 6'sı      & iyelik (kullanıcı si) \\
\verb|\trkappend{2}{'si}|     & \trkappend{2}{'si}     & 2'si      & iyelik (kullanıcı si) \\
\midrule
%% Vowel drop — ordinal (ünlü düşmesi, sıra sayısı)
\verb|\trkappend{2}{'inci}|   & \trkappend{2}{'inci}   & 2'nci     & ünlü düşmesi \\
\verb|\trkappend{3}{'inci}|   & \trkappend{3}{'inci}   & 3'üncü    & 4'lü+sertleşme \\
\verb|\trkappend{6}{'inci}|   & \trkappend{6}{'inci}   & 6'ncı     & ünlü düşmesi+arka \\
\verb|\trkappend{40}{'inci}|  & \trkappend{40}{'inci}  & 40'ıncı   & ünsüz son, yok \\
\midrule
%% Vowel drop — possessive (1sg) (ünlü düşmesi, iyelik)
\verb|\trkappend{2}{'im}|     & \trkappend{2}{'im}     & 2'm       & ünlü düşmesi \\
\verb|\trkappend{6}{'im}|     & \trkappend{6}{'im}     & 6'm       & ünlü düşmesi \\
\midrule
%% daş/taş (consonant alternates, vowel 'a' invariant)
\verb|\trkappend{3}{'daş}|    & \trkappend{3}{'daş}    & 3'taş     & sertleşme+sabit a \\
\verb|\trkappend{1}{'daş}|    & \trkappend{1}{'daş}    & 1'daş     & yumuşama+sabit a \\
\verb|\trkappend{6}{'daş}|    & \trkappend{6}{'daş}    & 6'daş     & ünlü+sabit a \\
\verb|\trkappend{3}{'daşlar}| & \trkappend{3}{'daşlar} & 3'taşlar  & daş+lar \\
\midrule
%% Invariant morphemes (büyük ünlü uyumuna uymayan ekler)
\verb|\trkappend{3}{'deki}|   & \trkappend{3}{'deki}   & 3'teki    & sertleşme+ki \\
\verb|\trkappend{6}{'deki}|   & \trkappend{6}{'deki}   & 6'daki    & arka+ki \\
\verb|\trkappend{6}{'dekilerden}| & \trkappend{6}{'dekilerden} & 6'dakilerden & bileşik ek \\
\verb|\trkappend{9}{'durken}| & \trkappend{9}{'durken} & 9'durken  & ken sabit \\
\bottomrule
\end{tabular}

% ── Cross-reference tests ──────────────────────────────────────────
\bigskip
\noindent
\begin{tabular}{lll}
\toprule
\textbf{Komut} & \textbf{Üretilen} & \textbf{Kural} \\
\midrule
\verb|\trkref{bolum:bir}{'inci}|   & \trkref{bolum:bir}{'inci}   & \verb|\ref| + ek \\
\verb|\trkref{bolum:iki}{'de}|     & \trkref{bolum:iki}{'de}     & \verb|\ref| + ek \\
\verb|\trkref{bolum:uc}{'de}|      & \trkref{bolum:uc}{'de}      & \verb|\ref| + ek \\
\verb|\trkref{alt:bir}{'de}|       & \trkref{alt:bir}{'de}       & alt bölüm 1.1 → son bileşen 1 \\
\verb|\trkref{alt:iki}{'de}|        & \trkref{alt:iki}{'de}        & alt bölüm 1.2 → son bileşen 2 \\
\verb|\trkpageref{bolum:bir}{'de}| & \trkpageref{bolum:bir}{'de} & \verb|\pageref| + ek \\
\verb|\trkpageref{sec:test}{'de}|  & \trkpageref{sec:test}{'de}  & \verb|\pageref| + ek \\
\bottomrule
\end{tabular}

% ── Override test ──────────────────────────────────────────────────
\bigskip
\noindent
\textbf{Geçersiz kılma (override) testi:}

% 100 (yüz): "'inci" → 'üncü,  "'de" → 'de.
% Override targets only 'üncü; the 'de suffix is unaffected.
\noindent
\begin{tabular}{ll}
\verb|\trkappend{100}{'inci}|                      & \trkappend{100}{'inci} \\
\verb|\trkappend{100}{'de}|                        & \trkappend{100}{'de} \\
\verb|\trksetoverride{100}{üncü}{uncu}|            & \trksetoverride{100}{üncü}{uncu}(etkin) \\
\verb|\trkappend{100}{'inci}|                      & \trkappend{100}{'inci} \\
\verb|\trkappend{100}{'de}|                        & \trkappend{100}{'de} \\
\verb|\trkremoveoverride{100}{üncü}|               & \trkremoveoverride{100}{üncü}(kaldırıldı) \\
\verb|\trkappend{100}{'inci}|                      & \trkappend{100}{'inci} \\
\end{tabular}

% ── Manual escape hatch ────────────────────────────────────────────
\bigskip
\noindent
\textbf{Manuel kaçış kapısı:}

\noindent
\begin{tabular}{ll}
\verb|\trkappend{6}{'de}|      & \trkappend{6}{'de} \\
\verb|\trkmanual{6}{'de}|      & \trkmanual{6}{'de} \\
\end{tabular}

% ── Bibliography reference tests ───────────────────────────────────
\bigskip
\noindent
\textbf{Kaynakça referansları — \texttt{\textbackslash trkbibappend}:}

\noindent
\begin{tabular}{llll}
\toprule
\textbf{Komut} & \textbf{Üretilen} & \textbf{Beklenen} & \textbf{Kural} \\
\midrule
\verb|\trkbibappend{3}{'de}|    & \trkbibappend{3}{'de}    & [3]'te    & sertleşme \\
\verb|\trkbibappend{6}{'de}|    & \trkbibappend{6}{'de}    & [6]'da    & ünlü uyumu \\
\verb|\trkbibappend{2}{'te}|    & \trkbibappend{2}{'te}    & [2]'de    & yumuşama \\
\verb|\trkbibappend{40}{'de}|   & \trkbibappend{40}{'de}   & [40]'ta   & sertleşme+arka \\
\verb|\trkbibappend{100}{'inci}| & \trkbibappend{100}{'inci} & [100]'üncü & 4'lü+sertleşme \\
\bottomrule
\end{tabular}

\bigskip
\noindent
\textbf{Kaynakça referansları — \texttt{\textbackslash trkbibref}:}

\noindent
\begin{tabular}{llll}
\toprule
\textbf{Komut} & \textbf{Üretilen} & \textbf{Beklenen} & \textbf{Kural} \\
\midrule
\verb|\trkbibref{yilmaz2022}{'de}|              & \trkbibref{yilmaz2022}{'de}              & [3]'te    & sertleşme \\
\verb|\trkbibref{celik2019}{'de}|               & \trkbibref{celik2019}{'de}               & [6]'da    & ünlü uyumu \\
\verb|\trkbibref{yilmaz2022,celik2019}{'de}|    & \trkbibref{yilmaz2022,celik2019}{'de}    & [3, 6]'da & listedeki son \\
\verb|\trkbibref{celik2019,yilmaz2022}{'de}|    & \trkbibref{celik2019,yilmaz2022}{'de}    & [6, 3]'te & listedeki son \\
\bottomrule
\end{tabular}

\begin{thebibliography}{99}
\bibitem[3]{yilmaz2022} Yılmaz, A. \textit{Türkçe Sesbilim: Ünlü Uyumu ve Ünsüz Değişimleri}. TDK Yayınları, 2022.
\bibitem[6]{celik2019}  Çelik, M. \textit{Türkçede Eklerin Ses Uyumu}. Ankara Üniversitesi Yayınları, 2019.
\end{thebibliography}

\end{document}