% Dokumentumosztaly beallitasa (12pt betumeret, A4-es papir)
\documentclass[a4paper,12pt]{article}

\usepackage[T1]{fontenc} % T1 betukodolas
\usepackage[utf8]{inputenc} % UTF-8 karakterkodolas engedelyezese

% 1. A magyar.ldf opciok atadasa
\PassOptionsToPackage{defaults=hu-min}{magyar.ldf} 
% 2. A babel betoltese
\usepackage[magyar]{babel} 

% Oldalmargók beállítása
\usepackage{geometry} % Geometria csomag a margókhoz
\geometry{margin=3cm} % 3 cm-es margó minden oldalon

% Színek betöltése a dokumentáció kiemeléseihez
\usepackage{xcolor} 

% Hiperhivatkozások beállítása a PDF-ben
\usepackage{hyperref}
\hypersetup{
    colorlinks=true,       % A linkek szövege lesz színes (nem dobozok)
    linkcolor=blue,        % Belső linkek színe (pl. tartalomjegyzék)
    urlcolor=blue,         % Külső webes linkek színe
    pdftitle={printcolormanager csomag dokumentáció}, % PDF metaadat: cím
    pdfauthor={Bihari Zsolt}  % PDF metaadat: szerző (Írd át a sajátodra!)
}

% Kódblokkok megjelenítésének formázása
\usepackage{listings}
\lstset{
    language=[LaTeX]TeX,           % A programozási nyelv LaTeX
    basicstyle=\ttfamily\small,    % Írógép (monospace) betűtípus
    backgroundcolor=\color{gray!10},% Világosszürke háttér a kódok mögött
    frame=single,                  % Szimpla keret a kódblokk körül
    keywordstyle=\color{blue},     % Parancsok kékkel
    commentstyle=\color{green!60!black}, % Megjegyzések sötétzölddel
    stringstyle=\color{orange}     % Szöveges értékek naranccsal
}

% Címlap adatai
\title{\textbf{A \texttt{printcolormanager} csomag}\\ \large Felhasználói kézikönyv}
\author{Bihari Zsolt \\ \href{mailto:info@tengerikajak.net}{info@tengerikajak.net}} % Írd át!
\date{v1.0 verzió -- \today} % Dátum automatikus generálása

% A tényleges dokumentum kezdete
\begin{document}

\maketitle % Címlap legenerálása

% Absztrakt (rövid összefoglaló) környezet
\begin{abstract}
A \texttt{printcolormanager} egy LaTeX csomag, amely egységes és automatizált színkezelést biztosít nyomdai és digitális kiadványokhoz. Segítségével ugyanaz a forrásdokumentum egyetlen csomagopció megváltoztatásával lefordítható CMYK (nyomdai), RGB (képernyős) vagy szürkeárnyalatos (fekete-fehér) változatban.
\end{abstract}

\tableofcontents % Tartalomjegyzék generálása
\vspace{2em}     % Függőleges térköz a tartalomjegyzék után

% Fejezet: Bevezetés
\section{Bevezetés}
Bár a LaTeX beépített \texttt{xcolor} csomagja sokrétű, a professzionális nyomdai előkészítés során gyakran gondot okoz a különböző színterek következetes használata. Az automatikus RGB-ből CMYK-ba történő matematikai konverzió sokszor "koszos" vagy pontatlan nyomdai színeket eredményez.

A \texttt{printcolormanager} ezt úgy oldja meg, hogy a csomag betöltésekor meghatározza a dokumentum globális színterét, az egyedi makrói révén pedig lehetővé teszi, hogy minden színhez manuálisan rendeljük hozzá az egzakt értékeket.

% Fejezet: Betöltés és opciók
\section{A csomag betöltése és opciói}
A csomagot a dokumentum preambulumában (a \verb|\documentclass| után) kell betölteni a kívánt cél-színtér megadásával:

% Kódblokk környezet
\begin{lstlisting}
\usepackage[CMYK]{printcolormanager}
\end{lstlisting}

A támogatott opciók az alábbiak:
\begin{itemize}
    \item \texttt{CMYK} vagy \texttt{cmyk}: Négyszínes nyomdai kimenet.
    \item \texttt{RGB} vagy \texttt{rgb}: Háromszínes digitális/képernyős kimenet.
    \item \texttt{gray}: Folytonos szürkeárnyalatos kimenet (0.0 és 1.0 között).
    \item \texttt{GRAY}: Diszkrét szürkeárnyalatos kimenet (egész számos).
    \item \texttt{HSB}: Árnyalat, telítettség és fényerő alapú színtér.
    \item \texttt{Lab}: CIE Lab színtér.
\end{itemize}

% Fejezet: Egyedi színek
\section{Egyedi színek definiálása}
A csomag legfontosabb eleme a \verb|\definePrintColor| makró. Ennek segítségével egy arculati szín összes lehetséges (RGB, CMYK, szürke stb.) értékét egyetlen parancsban adhatjuk meg.

\subsection{Szintaktika}
\begin{lstlisting}
\definePrintColor{Nev}{RGB}{CMYK}{GRAY}{HSB}{Lab}
\end{lstlisting}

\textbf{Példa egy "Márkapiros" szín megadására:}
\begin{lstlisting}
\definePrintColor{MarkaPiros}{210, 40, 40}{0.05, 0.95, 0.90, 0.0}%
{0.55}{0, 80, 80}{50, 65, 45}
\end{lstlisting}
A fordítás során a csomag megnézi, hogy milyen globális opcióval lett meghívva (pl. \texttt{[CMYK]}), és \textbf{automatikusan} a dedikált értékeket (jelen esetben a \texttt{0.05, 0.95, 0.90, 0.0}-t) alkalmazza matematikai konverzió nélkül.

% Fejezet: Nyomdai fekete
\section{Szövegfekete és Gazdag fekete}
A nyomdászatban el kell különíteni a szövegekhez használt tiszta feketét a sötét hátterekhez használt gazdag feketétől. A csomag beépítve adja ezt a két színt:
\begin{itemize}
    \item \verb|\textcolor{PureBlack}{szöveg}|: Tiszta fekete (\texttt{0.0, 0.0, 0.0, 1.0} CMYK). Vékony vonalakhoz és apró betűkhöz a nyomdai illeszkedési hibák elkerülése végett.
    \item \verb|\textcolor{RichBlack}{szöveg}|: Gazdag fekete (\texttt{0.40, 0.0, 0.0, 1.0} CMYK). Ciánt tartalmaz a mélyebb tónusért (nagy felületekhez).
\end{itemize}

\subsection{Kötelező paraméterek és üresen hagyott értékek}
A \verb|\definePrintColor| makró szigorúan \textbf{hat paramétert vár}. Nem hagyható el egyetlen kapcsos zárójel sem, különben a LaTeX fordítás hibára fut (\textit{Runaway argument}). 

Ha egy színnek nem ismerjük, vagy nem akarjuk megadni valamelyik (például HSB vagy Lab) értékét, a zárójeleket akkor is ki kell tenni. Ilyenkor érdemes helyettesítő (fallback) értéket beírni, vagy üresen hagyni a zárójelet:

\begin{lstlisting}
% Pelda ures HSB es Lab parameterekkel:
\definePrintColor{Peldaszin}{255,0,0}{0,1,1,0}{0.5}{}{}
\end{lstlisting}

\textbf{Figyelem:} Ha egy paramétert teljesen üresen hagyunk (pl. \texttt{\{\}}), ügyeljünk arra, hogy a dokumentumot soha ne fordítsuk le az ahhoz tartozó csomagopcióval (a példában \texttt{[HSB]} vagy \texttt{[Lab]}), mert az üres érték átadása az \texttt{xcolor} motornak szintén fordítási hibát okoz! A legbiztonságosabb, ha minden paraméterbe írunk valamilyen valós számértéket.

\end{document} % A dokumentum vége
