Git Product home page Git Product logo

guide's Introduction

Αποθετήριο πηγαίων αρχείων μορφοποίησης για την δυναμική δημιουργία του Οδηγού Σπουδών

Για την δημιουργία του οδηγού σπουδών θα βασιστούμε στο αποθετήριο δεδομένων του τμήματος, το οποίο έχει προστεθεί εδώ με την τεχνολογία git submodule, καθώς και στην ροή παραγωγής του βιβλίου του μαθήματος τα οποία θα πρέπει να μελετήσετε και να αποκτήσετε δεξιότητες με τα παραδείγματα που θα βρείτε εκεί.

Για την δημιουργία του Οδηγού Σπουδών θα χρησιμοποιήσουμε τα εργαλεία pandoc και weasyprint ή/και latex, τα οποία βασίζονται στην γραμμή εντολών και δουλεύουν καλύτερα σε συστήματα τύπου UNIX, π.χ, Linux, BSD, MacOSX. Με αρκετή υπομονή και επιμονή μερικές φορές δουλεύουν και σε Windows WSL.

Ο σκοπός της εργασίας είναι να γίνει συνεργατική επεξεργασία του αρχικού αρχείου που θα βρείτε στην επίσημη ιστοσελίδα και οργάνωση του σε επιμέρους αρχεία κεφαλαίων, έτσι ώστε να είναι εύκολη η μελλοντική επεξεργασία και ταυτόχρονα η αυτόματη σύνθεση τους στο τελικό αρχείο σε μορφή PDF-EPUB-mobi.

Η οργάνωση και επεξεργασία των αρχείων θα γίνει σε συντονισμό με το συγγενικό αποθετήριο κατασκευής ιστοσελίδας, έτσι ώστε από το σετ πηγαίων αρχείων all_collections να παράγεται τόσο η ιστοσελίδα όσο και ο οδηγός σπουδών.

Αυτό πρακτικά σημαίνει ότι μόνο τα δεδομένα που δεν υπάρχουν στο all_collections χρειάζονται εδώ, ενώ τα κοινά δεδομένα θα πρέπει να βρίσκονται στο submodule, που μοιράζονται τα δύο έργα. Επίσης, σημαίνει πως τα δεδομένα θα πρέπει να μετατραπούν σε κείμενο και πίνακες με φίλτρα και διεργασίες δέσμης, παρόμοιες με αυτές που θα βρείτε στο αποθετήριο του βιβλίου του μαθήματος που παράγεται με ανάλογο τρόπο.

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

Οι οδηγίες για την βαθμολόγηση και την διαδικασία συνεισφοράς είναι ίδιες με αυτές της συγγενικής εργασίας για την ιστοσελίδα.

Σχετικά έργα και εργαλεία

https://leanpub.com/

https://github.com/electricbookworks/electric-book

https://github.com/evangoer/pandoc-ebook-template

https://github.com/jd/asciidoc-book-toolchain

https://github.com/softcover/softcover

https://github.com/magicbookproject/magicbook

https://pubsweet.org/docs/core/overview.html

https://bookdown.org/home/about/

https://prepostprint.org/doku.php/en/resources

guide's People

Contributors

axileaszervos avatar epidrome avatar inf2021090 avatar nkanagno avatar

Watchers

 avatar  avatar  avatar  avatar

guide's Issues

Αφαίρεση του καθηγητή Εμμανουήλ Μάγκου από την κατηγορία Αναπληρωτές Καθηγητές και προσθήκη στην κατηγορία Καθηγητές

Δήλωση Θέματος

  • Σύντομη περιγραφή των επικείμενων αλλαγών
    • Αλλαγή:
      Αφαιρώ τον καθηγητή Εμμανουήλ Μάγκο από την κατηγορία Αναπληρωτές Καθηγητές και τον προσθέτω στην κατηγορία Καθηγητές.
  • Εκτιμώμενη δυσκολία: very easy
  • Σχετικοί συνεργατές: @nkanagno @inf2021090
  • Σχετικά σύνδεσμοι (π.χ., στην επίσημη ιστοσελίδα, προηγούμενα σχετικά θέματα):
    • Η επίσημη ιστοσελίδα των μελών ΔΕΠ του τμήματος πληροφορικής του ιονίου πανεπιστημίου.
    • Η επίσημη ιστοσελίδα του Διοικητικού Προσωπικού του τμήματος πληροφορικής του ιονίου πανεπιστημίου.
    • Η ανεπίσημη ιστοσελίδα του τμήματος πληροφορικής του ιονίου πανεπιστημίου.

Απορίες σχετικά με το θέμα (αν υπάρχουν)

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Προσθήκη φίλτρου lua για την ενότητα Έρευνα στο Τμήμα Πληροφορικής

Δήλωση Θέματος

  • Σύντομη περιγραφή των επικείμενων αλλαγών
    Το περιεχόμενο των εργαστηρίων βρίσκεται στον φάκελο _groups του all_collections, όλα τα αρχεία του έχουν την εξής δομή:
  1. metadata πχ ref link
  2. παράγραφοι
  3. λίστα με εφαρμογές κάποιες φορές

Για να μπορεί το περιεχόμενο να μεταφέρεται αυτόματα κατά την παραγωγή ενός εγγράφου pdf χρειάζεται η δημιουργία ενός lua φίλτρου με τα εξής χαρακτηριστικά:

  1. τμήμα που επεξεργάζεται τα μεταδεδομένα και τυπώνει τα απαραίτητα όπως όνομα εργαστηρίου και link
  2. επεξεργασία του υπόλοιπου μπλοκ κειμένου στο οποίο ελέγχει αν αυτό αντιστοιχεί σε παράγραφο ή λίστα ώστε να τυπωθεί με την κατάλληλη μορφή.

Απορίες σχετικά με το θέμα (αν υπάρχουν)

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Δημιουργία και προσθηκή φίλτρων lua, για την εμφάνηση των καθηγητών του οδηγού σπουδών

Δήλωση Θέματος

  • Σύντομη περιγραφή των επικείμενων αλλαγών

    • Αλλαγή:
      Δημιουργία τεσσάρων φίλτρων lua, με σκοπό την εμφάνιση σε pdf του κεφαλαίου ΚΑΘΗΓΗΤΈΣ του οδηγού σπουδών. Πιο συγκεκρινένα, δημιούργησα τέσσερα φίλτρα, τα οποία χρησιμοποιούνται για την κατηγοροποίηση των καθηγητών, δηλαδή ένα φίλτρο άνα κατηγορία.

  • Εκτιμώμενη δυσκολία: easy

  • Σχετικοί συνεργατές: @nkanagno @inf2021090

  • Σχετικά σύνδεσμοι (π.χ., στην επίσημη ιστοσελίδα, προηγούμενα σχετικά θέματα):

    • Η επίσημη ιστοσελίδα των μελών ΔΕΠ του τμήματος πληροφορικής του ιονίου πανεπιστημίου.
    • Η επίσημη ιστοσελίδα του Διοικητικού Προσωπικού του τμήματος πληροφορικής του ιονίου πανεπιστημίου.
    • Η ανεπίσημη ιστοσελίδα του τμήματος πληροφορικής του ιονίου πανεπιστημίου.

Απορίες σχετικά με το θέμα (αν υπάρχουν)

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Ενημέρωση αρχείων Επίκουρων Καθηγητών - Προσθήκη κατηγορίας excerpt

Δήλωση Θέματος

Απορίες σχετικά με το θέμα (αν υπάρχουν)

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Προσθήκη φίλτρων lua για τα μαθήματα του υποκεφαλαίου Περιεχόμενο Μαθημάτων της Ενότητας ΠΡΟΠΤΥΧΙΑΚΕΣ ΣΠΟΥΔΕΣ.

Δήλωση Θέματος

  • Σύντομη περιγραφή των επικείμενων αλλαγών
    • Αλλαγή:
      Προσθήκη φίλτρων .lua αρχείων που να παιρνουν ως παράμετρο το μάθημα σε μορφή .md που θα παίρνει από το all_collections και να εμφανίζει στο βιβλίο τον τίτλο (σε μορφή header 4 ####) και το περιεχόμενό του, χωρισμένα στο txt ανά εξάμηνο στο υποκεφάλαιο Περιεχόμενο Μαθημάτων της Ενότητας ΠΡΟΠΤΥΧΙΑΚΕΣ ΣΠΟΥΔΕΣ. Τα 4 διαφορετικά φίλτρα θα χωρίζονται σε 4 κατηγορίες:
      • Κορμού
      • Επιλογής
      • Κατεύθυνσης Πληροφοριακών Συστημάτων
      • Κατεύθυνσης Πληροφορική - Ανθρωπιστικές και Κοινωνικές Επιστήμες
  • Εκτιμώμενη δυσκολία: easy
  • Σχετικοί συνεργατές: @Axileaszervos @inf2021090
  • Σχετικά σύνδεσμοι (π.χ., στην επίσημη ιστοσελίδα, προηγούμενα σχετικά θέματα):

Απορίες σχετικά με το θέμα (αν υπάρχουν)

DEMO LINK

Σύνδεσμος σε προσωπικό issue που περιέχει το pdf βιβλίο demo

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Ενημέρωση αρχείων Διδακτικόυ Προσωπικόυ - Προσθήκη κατηγορίας excerpt

Δήλωση Θέματος

  • Σύντομη περιγραφή των επικείμενων αλλαγών
    • Αλλαγή:
      • Στα αρχεία του Διδακτικού Προσωπικόυ katomeris.md, alex.md, riggas.md, hristope.md λείπει η κατηγορία excerpt.
      • Στο αρχείο των Αναπληρωτών Καθηγητών mikalef.md λείπει η κατηγορία excerpt.
  • Εκτιμώμενη δυσκολία: easy
  • Σχετικοί συνεργατές: @Axileaszervos @inf2021090
  • Σχετικά σύνδεσμοι (π.χ., στην επίσημη ιστοσελίδα, προηγούμενα σχετικά θέματα):

Απορίες σχετικά με το θέμα (αν υπάρχουν)

Υπενθυμίσεις

  • Έχω βάλει σύντομο και μοναδικό τίτλο (π.χ., το όνομα της σελίδας ή της ανακοίνωσης)
  • Έχω ενημερώσει τα παραπάνω πεδία με περισσότερες λεπτομέρειες, όπως σύνδεσμος στην σελίδα που αλλάζω ή/και σύνδεσμο στην αντίστοιχη σελίδα της επίσημης σελίδας με την ενημερωμένη πληροφορία.
  • Έχω ελέγξει ότι το περιέχομενο των αλλαγών μου δεν το έχει δηλώσει κάποιος άλλος σε προηγούμενο issue ανοιχτό ή κλειστό
  • Πριν προχωρήσω σε pull request θα πάρω ετικέτα green light
  • Για την δεύτερη συνεισφορά έχω υλοποιήσει μια νέα λειτουργία και έχω εντοπίσει δύο σχετικούς αξιολογητές όπως φαίνεται στο λινκ που δίνω παραπάνω, διαφορετικά δεν γίνονται δεκτά θέματα που αφορούν απλή συνεισφορά περιεχομένου όπως στην πρώτη συνεισφορά

@epidrome

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.