ISTLab-web documentation: Difference between revisions

From Istlab
Jump to navigationJump to search
← Older edit
Content deleted Content added
Bkarak (talk | contribs)
206 edits
 
(25 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Η σελίδα είναι υπό κατασκευή. Επίσης μπορείτε να δείτε / κάνετε ερωτήσεις στο [[ FAQ ]].
This page is under construction.


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


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


== Εγκατάσταση ==
⚫
== Διαχείριση του διαδικτυακού τόπου ==

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

1. Έκδοση ζεύγους δημοσίου / ιδιωτικού κλειδιού και λογαριασμού για τον εξυπηρετητή '''istlab.dmst.aueb.gr'''<br/>
2. Ρύθμιση του putty, ώστε να μπορεί να εισάγεται ο χρήστης αυτόματα στον εξυπηρετήτη '''istlab.dmst.aueb.gr''' χωρίς να του ζητείται κωδικός και συνθηματικό [http://istlab.dmst.aueb.gr/~bkarak/cvs-tutorial.pdf Παρουσίαση]<br/>
3. Προσθήκη της μεταβλητής περιβάλλοντος '''CVSROOT''' στο σύστημα <pre>CVSROOT=:ext:istlab.dmst.aueb.gr:/home/dds/cvsroot</pre>
4. Προσθήκη της μεταβλητής περιβάλλοντος '''CVS_RSH''' στο σύστημα <pre>CVS_RSH=plink.exe (windows)</pre> ή <pre>CVS_RSH=ssh (unix)</pre>
5. Προσθήκη στη μετβλητή περιβάλλοντος '''PATH''' τον κατάλογο '''bin''' του τοπικού καταλόγου εγκατάστασης του '''istlab-web''' (μόνο για τους χρήστες MS-Windows). Για παράδειγμα: <pre>set PATH=%PATH%;c:\istlab-web\bin</pre>
6. Προσθήκη στο μητρώο (registry) των παρακάτω τιμών (μόνο για χρήστες windows)

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

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


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


* Ανάκτηση της τελευταίας έκδοσης
* Ανάκτηση της τελευταίας έκδοσης <pre>cvs update -dP</pre>
* Ανανέωση των XML δεδομένων
* Ανανέωση των XML δεδομένων
* Έλεγχος ορθότητας δεδομένων
* Έλεγχος ορθότητας δεδομένων <pre>make val</pre>
** Σημείωση: Αν χρησιμοποιείτε mac os χρειάζεστε το εργαλείο xmlstarlet (http://xmlstarlet.darwinports.com/)
* Δημιουργία των HTML
* Δημιουργία των HTML <pre>make html</pre>
⚫
* Ανανέωση του δικτυακού τόπου
* Προσθήκη αρχείου στην κεντρική αποθήκη (από τον κεντρικό κατάλογο του istlab-web)
** Για αρχεία τύπου text <pre>cvs add -m 'Σχόλιο' path/filename</pre>
** Για binary αρχεία <pre>cvs add -kb -m 'Σχόλιο' path/filename</pre>
* Ανανέωση της κεντρικές αποθήκης (από τον κεντρικό κατάλογο του istlab-web) <pre>cvs commit -m 'Σχόλιο'</pre>
⚫
* Ανανέωση του δικτυακού τόπου <pre>make dist</pre>


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


Χρησιμοποιώντας το εργαλείο cvs (από την γραμμή εντολών):
Χρησιμοποιώντας το εργαλείο cvs (από την γραμμή εντολών):
Line 31: Line 53:
* Κάθε επόμενη φορά: <pre>cvs update -dP istlab-web</pre>
* Κάθε επόμενη φορά: <pre>cvs update -dP istlab-web</pre>


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


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


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

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

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

* Αντιγράφουμε το αντίστοιχο πρότυπο από τον κατάλογο των προτύπων '''doc/template/''' (για βιβλιογραφική αναφορά επιλέγουμε ένα πρότυπο ανοίγοντας το αρχείο σε ένα κειμενογράφο).
* Μετονομάζουμε το αρχείο σε κάτι σχετικό με το περιεχόμενο του πχ για ένα μέλος της ομάδας με τον κωδικό του email του ('''bkarak -> m_bkarak.xml'''). Το όνομα δεν επηρεάζει την λειτουργία του συστήματος, αλλά προσοχή! '''Χρησιμοποιούμε ΜΟΝΟ λατινικούς χαρακτήρες'''.
* Συμπληρώνουμε τα αντίστοιχα πεδία της XML. Σβήνουμε ή περικλέιουμε σε σχόλια, <pre><!-- <alumnus/> --></pre> αυτά που δεν χρειαζόμαστε.
* Εκτελούμε <pre>make html</pre> για να σιγουρευτούμε ότι τα δεδομένα είναι σωστά.
* Εκτελούμε την εντολή <pre>cvs add [όνομα αρχείου]</pre> και μετά <pre>cvs commit -m '[σχόλιο]'</pre>
* Εκτελούμε <pre>make dist</pre> για να δημοσιοποιήσουμε τα δεδομένα στον ιστότοπο.

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

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

* Εντοπίζουμε το αρχείο που χρειάζετε την ανανέωση και το επεξεργαζόμαστε με τον αντίστοιχο κειμενογράφο.
* Εκτελούμε <pre>make html</pre> για να βεβαιωθούμε ότι οι αλλάγες είναι σωστές και εμφανίζονται στον ιστότοπο με ορθό τρόπο.
* Εκτελούμε <pre>cvs commit -m '[σχόλιο]'</pre> για να στείλουμε τις αλλαγές στο κεντρικό αποθετήριο.
* Εκτελούμε <pre>make dist</pre> για να δημοσιοποιήσουμε τις αλλαγές στο κεντρικό ιστότοπο του εργαστηρίου.

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

* Για τα δεδομένα XML: <pre>make val</pre>
* Δημιουργία του δικτυακού τόπου τοπικά (μόνο έτσι γίνεται έλεγχος των βιβλιογραφικών αναφορών): <pre>make html</pre>
* Οι καινούριες ιστοσελίδες βρίσκονται στο: <pre>public_html/index.html</pre>

Latest revision as of 12:13, 3 June 2010

Η σελίδα είναι υπό κατασκευή. Επίσης μπορείτε να δείτε / κάνετε ερωτήσεις στο 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
  • Δημιουργία των 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. Πιο συγκεκριμένα:

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

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

  • Αντιγράφουμε το αντίστοιχο πρότυπο από τον κατάλογο των προτύπων 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
Retrieved from "https://istlab.dmst.aueb.gr/wiki/index.php?title=ISTLab-web_documentation&oldid=2942"