From 6d00cca4faae6fc043cf35311a068122499d58bf Mon Sep 17 00:00:00 2001
From: Fanis Dokianakis <fanis@infloop.gr>
Date: Thu, 19 Aug 2021 13:46:49 +0300
Subject: [PATCH] new instructions doc

---
 Οδηγίες.md | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 Οδηγίες.md

diff --git a/Οδηγίες.md b/Οδηγίες.md
new file mode 100644
index 0000000..646eaae
--- /dev/null
+++ b/Οδηγίες.md
@@ -0,0 +1,104 @@
+### Οδηγίες
+
+Η νέα κεντρική ιστοσελίδα του HELLUG βασίζεται στη γεννήτρια στατικών site hugo,
+στο http://www.gohugo.io υπάρχουν λεπτομερείς οδηγίες για το συγκεκριμένο
+πρόγραμμα.
+Όλη η ανάπτυξη της ιστοσελίδας γίνεται με το git μέσω του περιβάλλοντος
+GitLab στο https://gitlab.com/hellug/www
+
+#### Νέο Άρθρο
+
+Κάθε άρθρο είναι ένα αρχείο στο φάκελο content/posts. Το αρχείο μπορεί να έχει τη κατάληξει html ή md
+και αυτό δείχνει τη μορφή του κειμένου που πρέπει να έχει το περιεχόμενο. Το όνομα του αρχείο είναι
+σημαντικό και θα είναι και στο url του site οπότε πρέπει να είναι στα λατινικά γράμματα και χωρίς κενά, τελείες ή σύμβολα.
+Επιτρέπεται μόνο η παύλα.
+
+Κάθε τέτοιο αρχείο χωρίζεται σε 2 μέρη, επικεφαλίδα και περιεχόμενο.
+
+##### Επικεφαλίδα
+Η επικεφαλίδα είναι στην αρχή του αρχείου και πρέπει να έχει αυτή τη μορφή:
+`
+---
+title: "Τίτλος Άρθρου"
+layout: "news"
+bannertemplate: "hellug-banner.html"
+date: 2021-08-19
+category_title: Σύλλογος
+tags: [Διοικητικό Συμβούλιο]
+peri-hellug: [dioikitiko-symvoulio]
+---
+`
+Όπου title βάζουμε το τίτλο του άρθρου, το layout και το bannertemplate το αφήνουμε ίδιο,
+εκτός αν θέλουμε κάποιο ειδικό θέμα για το συγκεκριμένο άρθρο. Στο date βάζουμε την ημερομηνία
+με αυτή τη μορφή. category_title είναι η κατηγορία που δίνεται και αφορά στο τρόπο που δημιουργούνται
+οι σελίδες περιεχομένων. Προσοχή στα εισαγωγικά, ακολουθήστε το άνω παράδειγμα.
+
+Διαθέσιμες κατηγορίες είναι οι
+* Σύλλογος
+* Δράσεις
+* Μέλη
+
+Τα tags είναι κάποιες ετικέτες που μπορούν να μπούν για να κατηγοριοποιούνται τα άρθρα,
+δείτε παραδείγματα σε παλαιότερα άρθρα
+
+Για κάθε κατηγορία υπάρχει ένα επιπλέων label που μπαίνει στο τέλος της επικεφαλίδας,
+δηλαδή:
+* Σύλλογος = peri-hellug
+* Δράσεις = draseis
+* Μέλη = meli
+
+Και περιέχει το όνομα του κυριότερου tag με λατινικούς χαρακτήρες και όπου κενό την παύλα.
+
+Προαιρετικά, υποστηρίζονται επιπλέων labels όπως το summary όπου γραφουμε μια εναλλακτική
+περίληψη στη περίπτωση που δε θέλουμε να μπει η πρώτη παράγραφος του περιεχομένου. Μέσα σε
+εισαγωγικά πάντα.
+
+##### Περιεχόμενο
+Το περιεχόμενο του άρθρου μπορεί να είναι είτε σε μορφή html είτε σε μορφή markdown. Ανάλογα
+τη μορφή το όνομα του αρχείου θα πρέπει να έχει είτε κατάληξη html είτε md.
+Οδηγίες για τη συγγραφή markdown θα βρείτε στο https://www.markdownguide.org/
+
+#### Νέες σελίδες
+Οι σελίδες είναι απλώς μια στατική σελίδα όπως το καταστατικό ή η σελίδα επικοινωνία. Μπαίνουν στο φάκελο content/pages,
+ανάλογα υπάρχουν επικεφαλίδα και περιεχόμενο. Δείτε τις άλλες σελίδες εκεί σαν παραδείγματα.
+
+#### Νέο Meetup
+Τα meetups είναι ειδικά άρθρα με τα επιπλέων labels
+* meetupdate - Η ημερομηνία και ώρα με μορφή 2019-07-14T20:30:00+03:00
+* meetuplocation
+
+Παράδειγμα επικεφαλίδας ενός meetup 
+`
+---
+title: "Hellug Meetups 2019"
+layout: "meetups"
+bannertemplate: "hellug-banner.html"
+date: 2019-05-31
+category_title: Δράσεις
+tags: [Meetups]
+draseis: [meetups]
+meetupdate: 2019-07-14T20:30:00+03:00
+meetuplocation: "MOZART CALDI"
+summary: "Κάθε Κυριακή βρισκόμαστε για δουλειές, τεχνικές συζητήσεις, καφέ και ποτάκι."
+---
+`
+
+#### Νέα Εκδήλωση
+Οι εκδηλώσεις είναι ειδικά άρθρα με το επιπλέων label, eventdate που έχει μορφή 2019-06-08
+
+Παράδειγμα επικεφαλίδας μιας εκδήλωσης
+`---
+title: "Ο HELLUG στο OPENFEST 2019"
+layout: "news"
+bannertemplate: "hellug-banner.html"
+date: 2019-06-02
+eventdate: 2019-06-08
+category_title: Δράσεις
+tags: [Εκδηλώσεις, Νέα]
+draseis: [news, event]
+summary: "Προσκαλούμε όλα τα μέλη και τους φίλους του Συλλόγου στο διήμερο Openfest2019, που θα γίνει το Σ/Κ 08-09/06/2019 στην Πανεπιστημιούπολη 1, του Πα.Δ.Α. (πρώην ΤΕΙ Αθήνας)."
+---
+`
+
+#### Links
+Οι λίστες των links που φαίνονται στην αρχική σελίδα είναι στο φάκελο data και μετά στο main ή στο sidebar ανάλογα με τη θέση τους.