%&program=xelatex
%&encoding=UTF-8 Unicode

\documentclass[letterpaper, 12pt]{article}
\usepackage[no-math]{fontspec}
\usepackage{polyglossia}
\usepackage{booktabs}
\usepackage{tabularx}
\usepackage{ltablex} 
\usepackage{longtable} 
\usepackage{lineno}
%\linenumbers
\usepackage{lettrine} 
\setmainlanguage[variant=polytonic]{greek}
\setmainfont{GFS Didot}
%\setotherlanguage[variant=polytonic]{greek}
\newfontfamily\greekfont[Script=Greek]{GFS Didot}
\newfontfamily\greekfontsf[Script=Greek]{GFS Didot}
\usepackage[pdfstartview=FitV,bookmarks=false]{hyperref}
\usepackage{url}
\usepackage{greektonoi}
\usepackage{byzantinemusic}
\usepackage{metalogo}
\usepackage{adjustbox}
\setmonofont[Scale=0.75]{DejaVu Sans Mono}
\newcommand\Ru{%%
\rule[.5cm]{0cm}{1.2cm}}
\def\tildde{{\char"007E}}
\definecolor{myRed}{rgb}{0.5,0,0}
%
\setmainlanguage{greek}
\let\tb=\textbackslash
\usepackage{titlesec}
\newfontfamily\subsubsectionfont{Times New Roman}
\titleformat*{\section}{\Large\bfseries\sffamily}
\titleformat*{\subsection}{\large\bfseries\sffamily}
\titleformat*{\subsubsection}{\itshape\subsubsectionfont}
%\usepackage{authblk}
\title{Documentation for the {\sf BMMusic Editor}}
\author{Charalampos Milt. Cornaros\thanks{\textcopyright 2016 Cornaros \& Tsiatsikas. Questions, commentary and bug reports to \texttt{kornaros@aegean.gr} please.}\and Zisis Tsiatsikas\thanks{\texttt{tzisis@aegean.gr}}}
\date{2016/04/16}
\begin{document}\begin{byzantinemusic}
\maketitle
%\begin{abstract}\end{abstract}
\tableofcontents

\section{Εισαγωγή}
Το  \textsf{BMMusic Editor}(Byzantine Music Editor) είναι ένα γραφικό περιβάλλον που προσφέρει στον χρήστη την δυνατότητα να δακτυλογραφεί τις εντολές του πακέτου \textsf{byzantinemusic} χωρίς λάθος και με μεγάλη ταχύτητα. Γράφτηκε από τον υποψήφιο διδάκτορα του τμήματος ΜΠΕΣ του Πανεπιστημίου Αιγαίου κ. Ζήση Τσιάτσικα στην γλώσσα Java σε συνεργασία με τον σχεδιαστή του πακέτου \textsf{byzantinemusic} επίκουρο καθηγητή κ. Κορνάρου Χαράλαμπου. 
\section{Περιγραφή του κειμενογράφου}
Ο κειμενογράφος αποτελείται από ένα κεντρικό μενού απ' το οποίο μπορούμε να επιλέξουμε κάποιο από τα παρακάτω κουμπιά: {\itshape Musical Symbols, Martyries-Isokrathmata-Stavros, Init. Martyries- Tempo Signatures} και {\itshape Measures-Fthores}.
\kentro{
\includegraphics[height=20mm]{menu.png}}
Πατώντας κάποιο απ' τα΄παραπάνω κουμπιά μπαίνουμε σε ένα νέο μενού που περιέχει αρκετά βοηθητικά κουμπιά. Έτσι, για παράδειγμα, αν επιλέξουμε να πατήσουμε το Musical Symbols θα πάρουμε την παρακάτω πίνακα από κουμπιά του Musical Symbols.
\kentro{
\includegraphics[height=70mm]{mainsymbols.png}}

Πατώντας ένα οποιοδήποτε απ' αυτά τα κουμπιά π.χ. το τρίτο από αριστερά(το oli) μας εισάγει το αντίστοιχο γράμμα μέσα στο μεσαίο δεξιό πεδίο. Συγχρόνως εμφανίζονται  μέσα σε ένα ημιδιάφανο πλαίσιο οι (περισσότερες) από τις επιλογές που έχουμε για να συντάξουμε μια εντολή που ξεκινάει με αυτό το γράμμα.  Για παράδειγμα, οι oli, olit, olig, olid ... είναι όλες επιτρεπτές εντολές που ξεκινάνε με το πρόθεμα oli. Πατώντας μια απ' αυτές, αλλάζουμε και την εντολή που βρίσκεται στο μεσαίο πεδίο. Αν, ο σκοπός μας ήταν να γράψουμε μια πολύ απλή εντολή π.χ την \tb oli τότε σχεδόν έχουμε τελειώσει: Αρκεί να τσεκάρουμε το \tb{} στα αριστερά του μεσαίου πεδίου, να γράψουμε μια συλλαβή στο κάτω πεδίο, για παράδειγμα, test και να πατήσουμε το μεσαίο Enter κουμπί. Θα δούμε το τελικό αποτέλεσμα στο μεγάλο κάτω παράθυρο μας: \tb th\{\tb oli\}\{test\}. Η \tb th είναι μια από τις πολλές εντολές του πακέτου \textsf{byzantinemusic} για να εισάγονται οι νότες με τις συλλαβές τους στο κείμενό μας. Αν έχουμε ήδη εγκαταστήσει το παραπάνω πακέτο στο σύστημά μας, τότε πατώντας το κουμπί Run και μετά από λίγο το κουμπί PDF θα έχουμε την δυνατότητα να δούμε και το  αποτέλεσμα που θα πάρουμε με την μηχανή \XeLaTeX{}.
 \subsubsection*{Σχόλιο.} \noindent Αν δεν δούμε να παράγεται κάποιο pdf αρχείο, τότε θα πρέπει να επεξεργαστούμε το αρχείο με την ονομασία\kentro{ BYZANTINE-MUSIC-EDITOR.conf} που βρίσκεται στον ίδιο φάκελο με το BMEditor.jar αρχείο. Όπως θα παρατηρήσουμε η πρώτη γραμμή είναι η PATH=xelatex. Αντί xelatex θα πρέπει να γράψουμε 
xelatex.exe, αν δουλεύουμε σε περιβάλλον Windows. Γενικά, δεξιά από το = θα πρέπει να ορίσουμε το κατάλληλο μονοπάτι στο οποίο βρίσκεται η \XeLaTeX{} μηχανή. Στην συνέχεια σώζουμε το conf αρχείο και ξαναπατάμε Run. Στην περίπτωση που  δεν έχουμε ακόμα καταφέρει να δούμε το pdf αρχείο μας, τότε  μπορούμε να ανοίξουμε το προσωρινό αρχείο που παράχθηκε με την ονομασία byzantinemusic-temp.tex και να το τρέξουμε με την \XeLaTeX{} μηχανή. 
\section{Γρήγορη και αργή χρήση του BMEditor}
Ο βασικός σκοπός του BMEditor είναι τα γράφουμε τις εντολές μας με όσο το δυνατόν λιγότερη πληκτρολόγηση και άρα καλύτερο χρόνο. Οι πιο συνηθισμένες εντολές είναι οι \tb th, \tb barth, \tb syn  και άλλες παρόμοιες. Αν αντί \tb th θέλουμε να πάρουμε την \tb barth, όπως για παράδειγμα  στον συνδυασμό \tb barth\{\tb oli\}\{test\} τότε, πριν πατήσουμε Enter, θα πρέπει να έχουμε τσεκάρει την επιλογή barth στα δεξιά μας. Αν όμως θέλουμε να εισάγουμε την \tb lth ή την \tb syn, ή οποιαδήποτε άλλη εντολή  αντί της \tb barth τότε θα πρέπει να τσεκάρουμε το th2 τετραγωνάκι και να γράψουμε στο διπλανό πεδίο την αντίστοιχη εντολή lth, syn ή όποια άλλη επιθυμούμε. Επανερχόμαστε στην χρήση της \tb th απλά αποτσεκάροντας τα th2 ή barth τετραγωνάκια. 

Υπάρχουν κάποιες σύνθετες περιπτώσεις συνδυασμών μουσικών συμβόλων που δεν αντιστοιχούν σε κάποια εντολή του \textsf{byzantinemusic} πακέτου. Για παράδειγμα, δεν υπάρχει εντολή που να θέτει πάνω στο \tb oli την φθορά \tb kediaf. Τότε μπορούμε πολύ απλά μετά την πρώτη εντολή \tb  να γράψουμε \tb kediaf και να πατήσουμε Enter. 
\kentro{
\includegraphics[height=70mm]{fast.png}}

Το αποτέλεσμα που θα πάρουμε θα είναι φυσικά το 
\kentro{
\tb th\{\tb oli\tb kediaf\}\{any syllable\} δηλ. το $\Rightarrow$ \fbox{\th{\oli\kediaf}[any syllable]}.} Αυτός είναι ο γρήγορος τρόπος εισαγωγής σύνθετων μουσικών εντολών. Θα πρέπει να είμαστε πολύ εξοικειωμένοι με την χρήση του πακέτου και αρκετά προσεκτικοί στο τι ακριβώς και που έχει επικολληθεί στο μεγάλο κάτω παράθυρο. Το οποιοδήποτε συντακτικό λάθος θα έχει σαν αποτέλεσμα να μην πάρουμε καμιά έξοδο! Για παράδειγμα, το \tb th\{\tb oli\tb kedia\}\{any syllable\}, θα δημιουργηθεί πρόβλημα γιατί δεν υπάρχει εντολή \tb kedia. Αυτό μπορούμε να το επιβεβαιώσουμε αν επιλέξουμε το μενού Measures-Fthores και γράψουμε στο μεσαίο πεδίο την λέξη kedia. Θα δούμε πολλές επιλογές όπως kediaf, kediafA, kediafD κοκ. αλλά καμία kedia. Σε τέτοιες περιπτώσεις καλό είναι να χρησιμοποιούμε την αργή μέθοδο εισαγωγής μουσικών χαρακτήρων. Με αυτήν την μέθοδο χτίζουμε ένα ένα μουσικό συνδυασμό στο πάνω πεδίο βήμα - βήμα. Τσεκάρουμε το προς τα πάνω βελάκι και γράφουμε oli. Πατώντας  το Enter η εντολή \tb oli ανεβαίνει στο πάνω πεδίο. Γράφουμε στο μεσαίο πεδίο μια άλλη εντολή, όπως για παράδειγμα την kediaf,  έχοντας επιλέξει το κατάλληλο μενού (σε  τούτο το παράδειγμα το Measures-Fthores).
\kentro{
\includegraphics[height=70mm]{normal.png}}
Πατώντας Enter το αποτέλεσμα ανεβαίνει από πάνω και έχουμε τον συνδυασμό \tb oli\tb kediaf. Με αυτόν τον τρόπο, μπορούμε να συνεχίσουμε το κτίσιμο ενός ολόκληρου μουσικού συνδυασμού από εντολές, που  η μία βρίσκεται μετά την άλλη. Μόλις έχουμε κτίσει τον τελικό συνδυασμό και έχουμε γράψει στο κάτω πεδίο την συλλαβή μας, τότε μπορούμε να τις μεταβιβάσουμε στο κεντρικό παράθυρο πατώντας το κουμπί Enter που βρίσκεται πάνω δεξιά δίπλα από το πάνω πεδίο εισαγωγής ή τον συνδυασμό Alt C. Αν έχουμε κάνει κάποιο λάθος μπορούμε να το διορθώσουμε με το Χ πριν πατήσουμε το Enter.

 \subsubsection*{Σχόλιο.} \noindent 
Η επιλογή [ ]  είναι χρήσιμη όταν θέλουμε να εισάγουμε εντολές που πρέπει να μπουν μέσα σε αγκύλες όπως για παράδειγμα, η εντολή \tb bm[\tb kediaf,0.1]. Σε τέτοιες περιπτώσεις εισάγουμε πρώτα την εξωτερική εντολή (π.χ. την \tb bm) στο πάνω πεδίο και στην συνέχεια γράφουμε στο μεσαίο πεδίο τα kediaf, 0.1 και τσεκάρουμε την επιλογή [ ]. Με Enter θα ανεβεί το [\tb kediaf,0.1] δίπλα στο προηγούμενο \tb bm και θα πάρουμε το σωστό τελικό  αποτέλεσμα \tb oli\tb bm[\tb kediaf,0.1]. To 2Gr είναι χρήσιμο όταν θέλουμε οι συλλαβές μας να είναι αποκλειστικά στα Ελληνικά ακόμα και αν είναι γραμμένες με λατινικούς χαρακτήρες στο κάτω πεδίο εισαγωγής.
\section{Χρήσιμες συντομογραφίες} Με Alt K ερχόμαστε στο μεσαίο παράθυρο ενώ με τον συνδυασμό Alt L στο μεσαίο κάτω. Με Alt M κατεβαίνουμε στο κάτω μεγάλο παράθυρο.
\section{Πληροφορίες για την άδεια χρήσης} Το πακέτο προορίζεται για προσωπική χρήση  στα πλαίσια της άδειας GPLv3. Στοχεύουμε στον ατομικό χρήστη και εραστή της Βυζαντινής Μουσικής, στην πανεύκολη και δωρεάν συγγραφή και ανταλλαγή μουσικών κειμένων μεταξύ των χρηστών του πακέτου, στην έρευνα της εκκλησιαστικής και παραδοσιακής μας μουσικής και στην κατασκευή μιας μεγάλης μουσικής βάσης Βυζαντινής Μουσικής που θα αγκαλιάσει το Πανεπιστήμιο Αιγαίου. Φυσικά, σε κάθε κείμενο γραμμένο με το \textsf{byzantinemusic} θα πρέπει να αναγράφεται  η ένδειξη ότι χρησιμοποιήθηκε το πακέτο \textsf{byzantinemusic}   \textcopyright  Cornaros 2016. 
 Για οποιαδήποτε σχόλια, ή  μουσικά κείμενα που έχετε κατασκευάσει και θέλετε να μας τα αποστείλετε, ή κάποια συνεργασία με σκοπό την βελτίωση του πακέτου \textsf{byzantinemusic} ή του \textsf{BMMusic Εditor} μπορείτε να στέλνετε email στους συγγραφείς.  
\end{byzantinemusic}
\end{document}
%\linethickness{4pt}
%\fbox{\begin{picture}(180,180)(1,1)
%
%\thicklines
%\put(30,20){\oval(40,20)[tl]}
%\thinlines
%%\linethickness{3pt}
%\put(60,60){\oval(40,20)}
%\end{picture}}