ISTLab-web documentation: Difference between revisions

From Istlab
Jump to navigationJump to search
← Older edit
Content deleted Content added
Bkarak (talk | contribs)
206 edits
 
(18 intermediate revisions by 5 users not shown)
Line 18: Line 18:
Η εγκατάσταση του περιβάλλοντος ανανέωσης γίνεται ακολουθώντας την εξής διαδικασία:
Η εγκατάσταση του περιβάλλοντος ανανέωσης γίνεται ακολουθώντας την εξής διαδικασία:


1. Έκδοση ζεύγους δημοσίου / ιδιωτικού κλειδιού και λογαριασμού στον εξυπηρετητή '''istlab.dmst.aueb.gr'''<br/>
1. Έκδοση ζεύγους δημοσίου / ιδιωτικού κλειδιού και λογαριασμού για τον εξυπηρετητή '''istlab.dmst.aueb.gr'''<br/>
2. Ρύθμιση του '''putty''', ώστε να μπορεί να εισάγεται ο χρήστης αυτόματα στον εξυπηρετήτη '''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>
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 39: Line 53:
* Κάθε επόμενη φορά: <pre>cvs update -dP istlab-web</pre>
* Κάθε επόμενη φορά: <pre>cvs update -dP istlab-web</pre>


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


Όλα τα αρχεία που περιέχουν τα δεδομένα βρίσκονται στο κατάλογο ''data''. Πιο συγκεκριμένα:
Όλα τα αρχεία που περιέχουν τα δεδομένα βρίσκονται στο κατάλογο ''data''. Πιο συγκεκριμένα:
Line 47: Line 61:
* Δεδομένα για τις ερευνητικές ομάδες '''data/groups/*.xml''' [[ προτυπο ερευνητικής ομάδας ]]
* Δεδομένα για τις ερευνητικές ομάδες '''data/groups/*.xml''' [[ προτυπο ερευνητικής ομάδας ]]
* Δεδομένα για την βιβλιογραφία '''data/publications/*.bib''' [[ προτυπο βιβλιογραφικών αναφορών ]]
* Δεδομένα για την βιβλιογραφία '''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>
* Για τα δεδομένα XML: <pre>make val</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"