ISTLab-web documentation

Η σελίδα είναι υπό κατασκευή. Επίσης μπορείτε να δείτε / κάνετε ερωτήσεις στο FAQ .

Ο δικτυακός τόπος του ISTLab

Διαχειρίζεται πληροφορίες για:

• ομάδες
• μέλη
• έργα
• δημοσιεύσεις

Οι τεχνολογίες που χρησιμοποιούνται είναι CVS, XML, XSLT, make, grep, BiBTeX και bib2html

Τα δεδομένα κρατούνται σε μορφή XML (μέλη, ομάδες, έργα) και η διαχείριση βιβλιογραφίας γίνεται με την χρήση BiBTeX. Γλώσσα μετασχηματισμού των δεδομένων είναι η XSLT, ενώ γίνεται έλεγχος ορθότητας των δεδομένων με XML validator.

Εγκατάσταση

Η εγκατάσταση του περιβάλλοντος ανανέωσης γίνεται ακολουθώντας την εξής διαδικασία:

1. Έκδοση ζεύγους δημοσίου / ιδιωτικού κλειδιού και λογαριασμού για τον εξυπηρετητή istlab.dmst.aueb.gr
2. Ρύθμιση του putty, ώστε να μπορεί να εισάγεται ο χρήστης αυτόματα στον εξυπηρετήτη istlab.dmst.aueb.gr χωρίς να του ζητείται κωδικός και συνθηματικό Παρουσίαση

3. Προσθήκη της μεταβλητής περιβάλλοντος CVSROOT στο σύστημα

CVSROOT=:ext:istlab.dmst.aueb.gr:/home/dds/cvsroot

4. Προσθήκη της μεταβλητής περιβάλλοντος CVS_RSH στο σύστημα

CVS_RSH=plink.exe (windows)

ή

CVS_RSH=ssh (unix)

5. Προσθήκη στη μετβλητή περιβάλλοντος PATH τον κατάλογο bin του τοπικού καταλόγου εγκατάστασης του istlab-web (μόνο για τους χρήστες MS-Windows). Για παράδειγμα:

set PATH=%PATH%;c:\istlab-web\bin

6. Προσθήκη στο μητρώο (registry) των παρακάτω τιμών (μόνο για χρήστες windows)

[HKEY_LOCAL_MACHINE\SOFTWARE\MiK\MiKTeX\CurrentVersion\MiKTeX]
"TeXMF Root Directories"=".\\bin"
"Local Root"=".\\bin"

Διαχείριση του Διαδικτυακού Τόπου

Η διαχείριση γίνεται ακολουθώντας τα παρακάτω βήματα:

• Ανάκτηση της τελευταίας έκδοσης

  cvs update -dP

• Ανανέωση των XML δεδομένων
• Έλεγχος ορθότητας δεδομένων

  make val

  • Σημείωση: Αν χρησιμοποιείτε mac os χρειάζεστε το εργαλείο xmlstarlet (http://xmlstarlet.darwinports.com/)
• Δημιουργία των HTML

  make html

• Προσθήκη αρχείου στην κεντρική αποθήκη (από τον κεντρικό κατάλογο του istlab-web)
  • Για αρχεία τύπου text

    cvs add -m 'Σχόλιο' path/filename

  • Για binary αρχεία

    cvs add -kb -m 'Σχόλιο' path/filename

• Ανανέωση της κεντρικές αποθήκης (από τον κεντρικό κατάλογο του istlab-web)

  cvs commit -m 'Σχόλιο'

• Ανανέωση του δικτυακού τόπου

  make dist

Ανάκτηση της Τελευταίας Έκδοσης

Χρησιμοποιώντας το εργαλείο cvs (από την γραμμή εντολών):

• Την πρώτη φορά:

  cvs co istlab-web

• Κάθε επόμενη φορά:

  cvs update -dP istlab-web

Αρχεία Δεδομένων

Όλα τα αρχεία που περιέχουν τα δεδομένα βρίσκονται στο κατάλογο data. Πιο συγκεκριμένα:

• Δεδομένα για τα μέλη data/members/*.xml πρότυπο μέλους
• Δεδομένα για τα έργα data/projects/*.xml προτυπο έργου
• Δεδομένα για τις ερευνητικές ομάδες data/groups/*.xml προτυπο ερευνητικής ομάδας
• Δεδομένα για την βιβλιογραφία data/publications/*.bib προτυπο βιβλιογραφικών αναφορών
• Δεδομένα για τις ανακοινώσεις data/announce/*.xml πρότυπο ανακοινώσεων

Εισαγωγή Νέων Δεδομένων

Για την καταχώρηση νέων δεδομένων στο σύστημα ακολουθείται η παρακάτω διαδικασία:

• Αντιγράφουμε το αντίστοιχο πρότυπο από τον κατάλογο των προτύπων doc/template/ (για βιβλιογραφική αναφορά επιλέγουμε ένα πρότυπο ανοίγοντας το αρχείο σε ένα κειμενογράφο).
• Μετονομάζουμε το αρχείο σε κάτι σχετικό με το περιεχόμενο του πχ για ένα μέλος της ομάδας με τον κωδικό του email του (bkarak -> m_bkarak.xml). Το όνομα δεν επηρεάζει την λειτουργία του συστήματος, αλλά προσοχή! Χρησιμοποιούμε ΜΟΝΟ λατινικούς χαρακτήρες.
• Συμπληρώνουμε τα αντίστοιχα πεδία της XML. Σβήνουμε ή περικλέιουμε σε σχόλια,

  <!-- <alumnus/> -->

  αυτά που δεν χρειαζόμαστε.
• Εκτελούμε

  make html

  για να σιγουρευτούμε ότι τα δεδομένα είναι σωστά.
• Εκτελούμε την εντολή

  cvs add [όνομα αρχείου]

  και μετά

  cvs commit -m '[σχόλιο]'

• Εκτελούμε

  make dist

  για να δημοσιοποιήσουμε τα δεδομένα στον ιστότοπο.

Τροποπόιηση Δεδομένων

Για την τροποποίηση ήδη υπρχόντων δεδομένων του συστήματος,

• Εντοπίζουμε το αρχείο που χρειάζετε την ανανέωση και το επεξεργαζόμαστε με τον αντίστοιχο κειμενογράφο.
• Εκτελούμε

  make html

  για να βεβαιωθούμε ότι οι αλλάγες είναι σωστές και εμφανίζονται στον ιστότοπο με ορθό τρόπο.
• Εκτελούμε

  cvs commit -m '[σχόλιο]'

  για να στείλουμε τις αλλαγές στο κεντρικό αποθετήριο.
• Εκτελούμε

  make dist

  για να δημοσιοποιήσουμε τις αλλαγές στο κεντρικό ιστότοπο του εργαστηρίου.

Έλεγχος Ορθότητας Δεδομένων

• Για τα δεδομένα XML:

  make val

• Δημιουργία του δικτυακού τόπου τοπικά (μόνο έτσι γίνεται έλεγχος των βιβλιογραφικών αναφορών):

  make html

• Οι καινούριες ιστοσελίδες βρίσκονται στο:

  public_html/index.html