Instruction file imported from costasdroid/SchoolPresentations (.github/instructions/latex.instructions.md). Copyright stays with the author.

Ενοποιημένες Οδηγίες LaTeX & Project (SchoolPresentations)

Περιγραφή

Το αποθετήριο περιέχει παρουσιάσεις μαθηματικών Λυκείου στα Ελληνικά με LaTeX Beamer. Όλες οι οδηγίες συγγραφής, μορφοποίησης, αρχιτεκτονικής, workflow και build περιλαμβάνονται εδώ.

Αυτό το αρχείο είναι η “canonical source of truth” για το project. Το README.md είναι το quick-start, αλλά οι κανόνες εδώ είναι οι επίσημοι.

Δομή & Οργάνωση

• Αρχεία root: presentation.cls (κεντρικό class, v2.7), README.md, LICENSE (CC BY-SA 4.0)
• Φάκελοι τάξεων: Α Λυκείου/, Β Λυκείου/, Γ Λυκείου/, Φυσική/
• Τοπικό presentation.cls: Κάθε φάκελος τάξης έχει δικό του presentation.cls (συνήθως κληρονομεί από το root)
• Δομή φακέλων: Τα .tex αρχεία τοποθετούνται συνήθως απευθείας στον φάκελο τάξης. Επιτρέπονται υποφάκελοι για:
  • ξεχωριστές εκπαιδευτικές κατευθύνσεις (π.χ. Κατεύθυνση/ στο Β Λυκείου)
  • μεγάλες θεματικές ενότητες με πολλά αρχεία (π.χ. Άλγεβρα/, Στατιστική/)
  • πόρους: images/, moodle/, Methodology/
  • όχι υποφάκελος για κάθε μεμονωμένο θέμα/παρουσίαση
• Generated αρχεία: .pdf, .nav, .snm, .synctex.gz κλπ αγνοούνται — δεν τα επεξεργαζόμαστε

Ονοματολογία αρχείων

• Μορφή: κεφάλαιο.ενότητα[.υποενότητα] Τίτλος.tex (π.χ. 2.5.1 Θεώρημα Rolle.tex)
• Ο τίτλος στα Ελληνικά ακολουθεί τους αριθμούς, χωρισμένος με κενό

Δομή αρχείου παρουσίασης

Κάθε αρχείο ξεκινά με το παρακάτω boilerplate:

\documentclass{presentation}

\title{Τίτλος στα Ελληνικά}
\subtitle{Υπότιτλος στα Ελληνικά}
\author[Λόλας]{Κωνσταντίνος Λόλας}
\institute[$10^ο$ ΓΕΛ]{$10^ο$ ΓΕΛ Θεσσαλονίκης}

\begin{document}

\begin{frame}
  \titlepage
\end{frame}

\section{Θεωρία}

% frames θεωρίας...

\moodle

\section{Ασκήσεις}

\exercises

\begin{askisi}
  Κείμενο άσκησης...
\end{askisi}

\end{document}

Σημαντικό:

• Χρησιμοποιούμε πάντα \documentclass{presentation} (όχι σχετικό path)
• Δεν βάζουμε \date{} — το cls το προσθέτει αυτόματα
• Η πρώτη σελίδα πρέπει να έχει πλήρη title page και να παραμένει σε συνεπή ύφος με τα υπόλοιπα αρχεία

Περιεχόμενο παρουσίασης

1. \section{Θεωρία}
2. Πολλαπλά θεωρητικά frames με \begin{frame}{τίτλος} ... \end{frame}
3. Frame με οδηγία για Moodle (π.χ. \moodle ή custom frame)
4. \section{Ασκήσεις}
5. Separator frame: \exercises
6. Κάθε άσκηση σε ξεχωριστό \begin{askisi} ... \end{askisi}

Κανόνες ύφους:

• Οι τίτλοι είναι ευρηματικοί/χιουμοριστικοί, αλλά όχι “για το θεαθήναι”
• Τα περιεχόμενα των frames να είναι σύντομα και περιεκτικά
• Λίστες: \begin{enumerate}[<+->] ή \begin{itemize}[<+->] για σταδιακή αποκάλυψη
• Θεωρήματα/ορισμοί: \begin{block}{Τίτλος} ... \end{block}
• Εικόνες: \includegraphics{} με path σχετικό ως προς το .tex αρχείο

Custom Environments & Commands

• askisi: Άσκηση (auto-numbered)
• lisi: Λύση (auto-numbered)
• apodiksi: Απόδειξη (auto-numbered, προαιρετικός τίτλος)
• \moodle: Τυπικό frame για οδηγία προς Moodle
• \exercises: Εμφανές frame "Ασκήσεις" (με beamercolorbox)

Παράδειγμα askisi

\begin{askisi}
  Δίνεται η συνάρτηση $f(x)=x^3-6x^2+9x$
  \begin{enumerate}
    \item<1-> Να δείξετε ότι η $f$ ικανοποιεί τις υποθέσεις του θ. Rolle στο $Δ=[0,3]$
    \item<2-> Να βρείτε τα $\xi\in(0,3)$ για τα οποία ισχύει $f'(\xi)=0$
  \end{enumerate}
  % \hyperlink{Λύση1}{\beamerbutton{Λύση}}
\end{askisi}

Γενικοί κανόνες συγγραφής

• Όλο το περιεχόμενο (τίτλοι, εντολές, σχόλια) στα Ελληνικά
• Δεν χρησιμοποιούμε \date{}
• Μαθηματικά: $...$ ή \[...\]
• Χρώμα/έμφαση τίτλων ασκήσεων: beamercolorbox
• Όλα τα frames, blocks, λίστες και ασκήσεις να ακολουθούν το ύφος των παραδειγμάτων του project

Build & validation

Compile

latexmk -xelatex -interaction=nonstopmode -synctex=1 -file-line-error <όνομα-αρχείου>.tex

Πρακτική συμβουλή

• προτίμησε το latexmk αντί για απευθείας xelatex για πιο ομαλή επανεκτέλεση
• αν το project ανοίγει σε VS Code, χρησιμοποίησε το LaTeX Workshop recipe latexmk (xelatex)
• για έλεγχο σύνταξης, αρκεί ένα compile χωρίς PDF output σε draft mode όταν χρειάζεται γρήγορη διασταύρωση

Checklist πριν το commit

• σωστή ονοματολογία αρχείου
• σωστό \documentclass{presentation}
• δεν υπάρχει \date{}
• περιεχόμενο στα Ελληνικά
• διαφάνειες σύντομες και διδακτικές
• η θεωρία και οι ασκήσεις συμφωνούν
• το αρχείο compiles με XeLaTeX
• δεν υπάρχουν generated files στο repo

Πρόσθετα conventions & build

• Build: XeLaTeX (latexmk), Calibri, Beamer (CambridgeUS, seagull), tikz, pgfplots, polynom, multicol, xgreek
• Συχνά patterns: piecewise, συστήματα, progressive reveal με <+-> ή \pause
• Όχι: subfolders για θεματικές, generated αρχεία, αγγλικά για το project content

Παραδείγματα patterns

Piecewise

f(x)=\begin{cases}
  x^2+2, & x<2 \\
  \frac{2}{\sin x}, & x>5 \\
  -\sqrt{2}, & x=3
\end{cases}

Σύστημα εξισώσεων

\begin{cases}
  2x+y=4 \\
  5x+2y=10
\end{cases}

Workflow

1. Δημιουργία .tex με σωστή ονοματολογία
2. Standard boilerplate
3. Θεωρία με engaging frames
4. Frame Moodle
5. Ασκήσεις με \exercises separator
6. Κάθε άσκηση σε \begin{askisi}
7. Compile με XeLaTeX

Versioning

• Το presentation.cls έχει version tracking (π.χ. 2.7)
• Η πληροφορία εμφανίζεται στην title slide

Μην...

• Μην χρησιμοποιείς relative path στο \documentclass
• Μην βάζεις \date{}
• Μην δημιουργείς υποφάκελο για κάθε μεμονωμένη παρουσίαση
• Μην επεξεργάζεσαι generated αρχεία (.pdf, .nav, .snm, .log, κλπ.)
• Μην γράφεις στα αγγλικά όταν το project είναι στα Ελληνικά
• Μην αγνοείς τη δομή υποφακέλων που ήδη υπάρχει (Άλγεβρα/, Κατεύθυνση/, Στατιστική/ κλπ)

AI συγγραφική συμπεριφορά

Όταν δημιουργείς νέο εκπαιδευτικό υλικό:

Ύφος

• Μιμήσου το ύφος των υπαρχουσών παρουσιάσεων και όχι ένα γενικό "χιουμοριστικό εκπαιδευτικό ύφος".
• Το χιούμορ χρησιμοποιείται για να υπηρετήσει τη διδακτική αφήγηση.
• Μην προσθέτεις αστείο σε κάθε frame.
• Προτίμησε ευρηματικούς τίτλους που δημιουργούν απορία, προσδοκία ή ανατροπή.
• Διατήρησε σύντομο και προφορικό ύφος.
• Μην κάνεις το κείμενο πιο ακαδημαϊκό ή πιο "καλογραμμένο" από τα υπάρχοντα παραδείγματα.
• Μην εξηγείς γραπτώς όσα προορίζονται για προφορική διδασκαλία.

Διδακτική ροή

Η θεωρία δεν πρέπει να είναι απλή παράθεση ορισμών.

Όπου είναι φυσικό:

1. παρουσίασε μια παρατήρηση ή απορία,
2. άφησε να εμφανιστεί η ανάγκη για τη νέα έννοια,
3. εισήγαγε τη μαθηματική έννοια,
4. εξέτασε τις φυσικές απορίες/ειδικές περιπτώσεις,
5. κατέληξε στη συστηματική διαδικασία ή στις ιδιότητες,
6. ακολούθησε με ασκήσεις που χρησιμοποιούν αυτά που μόλις διδάχθηκαν.

Ασκήσεις

Οι ασκήσεις πρέπει να αντιστοιχούν στη θεωρία της ίδιας παρουσίασης.

Για κάθε νέα έννοια προσπάθησε, όπου είναι κατάλληλο, να υπάρχει συνδυασμός:

• άμεσης εφαρμογής,
• άσκησης που απαιτεί επιλογή κατάλληλης τεχνικής,
• άσκησης με συνηθισμένη παγίδα,
• πιο σύνθετης άσκησης.

Μην εισάγεις στις ασκήσεις τεχνικές ή γνώσεις που δεν έχουν παρουσιαστεί ή θεωρούνται προαπαιτούμενες.

Όταν ζητείται νέο υλικό

Πριν γράψεις νέο section:

• διάβασε σχετικά υπάρχοντα .tex αρχεία,
• εντόπισε τη χρησιμοποιούμενη ορολογία και συμβολισμό,
• εντόπισε σχετικά υπάρχοντα παραδείγματα και ασκήσεις,
• απέφυγε επανάληψη ήδη χρησιμοποιημένων ασκήσεων,
• διατήρησε τη συνέχεια με τις προηγούμενες παρουσιάσεις.

ΜΗΝ

• επινοείς νέο γενικό teaching style,
• μετατρέπεις τις παρουσιάσεις σε βιβλίο,
• γεμίζεις τα frames με κείμενο,
• χρησιμοποιείς υπερβολικό χιούμορ,
• δίνεις generic ασκήσεις που απλώς σχετίζονται με το topic.