Πληροφορίες για διαχειριστές ιστού
Εισαγωγή
Οι τεχνολογίες και τα προγράμματα που χρησιμοποιούνται για τη συντήρηση του ιστοτόπου του FSFE θα πρέπει να είναι οικεία σε πολλούς προγραμματιστές και δημιουργούς και θα μπορούσαν επίσης να ενδιαφέρουν όσους δεν τα έχουν ακόμη ανακαλύψει.
Μεταφραστές και περιστασιακοί εθελοντές είναι το πιθανότερο να έρθουν σε επαφή με τα
- Savannah -- για CVS (δείτε παρακάτω) υπηρεσίες και διαχείριση των εγκρίσεων πρόσβασης
- XHTML -- από τα οποία στατικές σελίδες δημιουργούνται αυτόματα κάθε 5 λεπτά
- Concurrent Version System (CVS) -- για συντονισμό και συγχρονισμό
Εθελοντές που ενδιαφέρονται να πάνε βαθύτερα στη διαδικασία συντήρησης πρέπει να είναι επίσης εξοικειωμένοι με
- Perl -- για τη συντήρηση των scripts με τα οποία γίνεται και η δημιουργία ιστοσελίδων
- Apache -- τον εξυπηρετητή ιστού
Κατανόηση του τρόπου κατασκευής των ιστοσελίδων
Οι ιστοσελίδες του www.fsfeurope.org συντηρούνται ως ένα σύνολο από XML αρχεία. Ο εξυπηρετητής ιστού παράγει τις HTML σελίδες από αυτά τα XML αρχεία αυτόματα κάθε πέντε λεπτά. Συνεπώς, όλη η επεξεργασία των σελίδων γίνεται μέσα στα XML αρχεία, και οι HTML σελίδες ποτέ δεν γίνονται αντικείμενο άμεσης επεξεργασίας.
Κάθε σελίδα στον www.fsfeurope.org ονομάζεται
"όνομα_σελίδας.γλώσσα.html" (με τη γλώσσα να είναι ο
iso-639 κωδικός δύο γραμμάτων της γλώσσας, όπως ''en'' για τα αγγλικά ή
"de" για τα γερμανικά). Τα πηγαία αρχεία ονομάζονται
"όνομα_σελίδας.γλώσσα.xhtml".
Μερικές σελίδες έχουν ένα δυναμικό μέρος: εκτός από το σταθερό κείμενο που
λαμβάνεται από το .xhtml αρχείο, περιλαμβάνουν και πληροφορίες από ένα ή
περισσότερα .xml αρχεία. Όποτε μια τέτοια σελίδα κατασκευάζεται, το σύστημα
παίρνει τα μεταφρασμένα .xml αρχεία, αν είναι διαθέσιμα, και επιστρέφει στην
αγγλική έκδοση αυτών των .xml αρχείων τα οποία δεν έχουν ακόμη μεταφραστεί.
Με αυτόν τον τρόπο, οι σελίδες καταλήγουν να αποτελούνται από ορισμένα τμήματα
μεταφρασμένα και άλλα τμήματα στα αγγλικά. Παραδείγματα τέτοιων σελίδων είναι
η αρχική σελίδα, η
σελίδα των ειδήσεων, και η
σελίδα των εκδηλώσεων.
Εγγραφή στη savannah
Τα πηγαία αρχεία για τις ιστοσελίδες είναι αποθηκευμένα στη Savannah, έναν εξυπηρετητή που φιλοξενείται στο Ίδρυμα Ελεύθερου Λογισμικού, τον ομοθυγατρικό μας οργανισμό στη Βόρεια Αμερική. Για να αποκτήσετε πρόσβαση εγγραφής σε αυτά τα αρχεία, μπορείτε να δημιουργήσετε έναν λογαριασμό σε αυτόν τον εξυπηρετητή.
Αποκτώντας ένα νέο λογαριασμό
Ακολουθήστε αυτό τον σύνδεσμο για να αποκτήσετε ένα νέο λογαριασμό. Επιλέξτε ένα όνομα χρήστη, έναν κωδικό, συμπληρώστε το πραγματικό σας όνομα και τη διεύθυνση του ηλεκτρονικού ταχυδρομείου σας και πατήστε το κουμπί ''Submit''.
Θα λάβετε ένα μήνυμα από τη savannah. Για να ολοκληρωθεί η εγγραφή σας, επισκεφθείτε το URL που αναγράφεται στο μήνυμα. Λογαριασμοί που δεν επιβεβαιώνονται, μετά από δύο ημέρες διαγράφονται από τη βάση δεδομένων.
Αφού επιβεβαιώσετε τον λογαριασμό σας, μπορείτε να συνδεθείτε στη σελίδα https://savannah.gnu.org με το όνομα χρήστη και τον κωδικό που επιλέξατε.
Δημιουργία ενός SSH κλειδιού
Ενώ μπορείτε να χρησιμοποιείτε τον κωδικό σας για να συνδεθείτε με την πύλη ιστού στη Savannah, πρέπει να δηλώσετε ένα SSH κλειδί για να έχετε πρόσβαση στο CVS. Αυτό πρέπει να γίνει σε κάθε μηχάνημα από όπου θα εισέλθετε στον αποθηκευτικό χώρο (repository) του CVS.
Για να δημιουργήσετε και να δηλώσετε ένα κλειδί SSH, παρακαλούμε ακολουθείστε τις οδηγίες που δίνονται στις Συχνές Ερωτήσεις (FAQ) του Savannah.
Συμμετέχοντας στο πρόγραμμα FSFE
Υπάρχουν πολλά προγράμματα που φιλοξενεί η Savannah, και η πρόσβαση στο CVS παραχωρείται με βάση το συγκεκριμένο πρόγραμμα. Για να αποκτήσετε πρόσβαση στα πηγαία αρχεία των ιστοσελίδων του FSFE, πρέπει να γίνετε μέλος του προγράμματος FSFE.
Επιλέξτε ''Group Membership'' στις καρτέλες της κορυφής. Τώρα μπορείτε να γράψετε ''FSFE'' στο πλαίσιο εισαγωγής κειμένου για αναζήτηση της επιλογής ''Request for Inclusion'', να ενεργοποιήσετε την ένδειξη στο τετραγωνάκι του FSF Europe και να γράψετε ένα σχόλιο.
Οι διαχειριστές του προγράμματος FSFE θα λάβουν τότε ένα μήνυμα με το αίτημά σας και το σχόλιο που δώσατε και θα μπορέσουν να εγκρίνουν την εγγραφή σας ως μέλος του προγράμματος. Μετά από αυτό θα πρέπει να μπορείτε να διακρίνετε την ένδειξη ''FSF Europe'' στα ''Groups I'm Contributor of'' μετά την είσοδό σας στη savannah.
Αρχική αντιγραφή του περιεχομένου του αποθηκευτικού χώρου
Πρώτα πρέπει να βεβαιωθείτε ότι το αρχείο ~/.bashrc στον ηλεκτρονικό σας
υπολογιστή περιέχει τη γραμμή
export CVS_RSH=ssh
μετά δημιουργήστε έναν κατάλογο αρχειοθέτησης (directory) για τον
αποθηκευτικό χώρο και εκτελέστε την εντολή
$ cvs -z3 -d username@cvs.savannah.gnu.org:/web/fsfe co
.
σε αυτόν τον κατάλογο. Τώρα θα σας ζητηθεί να δώσετε την SSH κωδική φράση.
Δώστε τη φράση και επιβεβαιώστε. Αν όλα πάνε καλά, τώρα ο ιστότοπος θα
πρέπει να αρχίσει να αντιγράφεται στον υπολογιστή σας.
Δουλεύοντας με τον αποθηκευτικό χώρο
Αφού αντιγράψατε τον αποθηκευτικό χώρο για πρώτη φορά, θα πρέπει να
εκτελέσετε την εντολή
$ cvs update -d
στον κατάλογο fsfe κάθε φορά πριν εργαστείτε με κάποιο συγκεκριμένο αρχείο.
Αν θέλετε να προσθέσετε νέα αρχεία στον αποθηκευτικό χώρο, χρειάζεται
να εκτελέσετε την εντολή
$ cvs add filename
Για να στείλετε τις αλλαγές σας στον εξυπηρετητή, ανεξάρτητα αν πρόκειται
για νέο αρχείο ή για τροποποίηση κάποιου υπάρχοντος, εκτελέστε την εντολή
$ cvs commit filename
και ένας απλός επεξεργαστής κειμένου θα ανοίξει για να δώσετε κάποια
περιγραφή των αλλαγών που πραγματοποιήσατε.
Μπορείτε να κατεβάσετε ένα λεπτομερές εγχειρίδιο για το CVS στην κεντρική σελίδα του CVS.
Αν θέλετε να κρατήσετε το ιστορικό των αλλαγών που έγιναν στα πηγαία αρχεία των ιστοσελίδων, μπορείτε να εγγραφείτε στον κατάλογο παραληπτών γνωστοποιήσεων του CVS και θα λάβετε ένα μήνυμα για κάθε αλλαγή που έχει αποσταλλεί στο source tree.
Υπεύθυνος χειρισμός της πρόσβασης για εγγραφή
Αν έχετε πρόσβαση για εγγραφή στις ιστοσελίδες, παρακαλούμε εγγραφείτε στον κατάλογο παραληπτών αλληλογραφίας διαχειριστών.
Σας υπενθυμίζουμε ότι όλες οι αλλαγές που κάνετε θα έχουν αποτέλεσμα και θα γίνουν ορατές αυτόματα, χωρίς άλλη ενέργεια τρίτων. Συνεπώς, υπάρχουν μερικά πράγματα που θα θέλαμε να σας ζητήσουμε να κάνετε όποτε αντιγράφετε στον εξυπηρετητή αλλαγές με νέα αρχεία:
-
Το FSFE έχει την ευθύνη για το περιεχόμενο των ιστοσελίδων. Παρακαλούμε μην στέλνετε στον εξυπηρετητή τροποποιήσεις που αλλάζουν το νόημα του κειμένου χωρίς έγκριση από ένα μέλος της ομάδας πυρήνα του FSFE. (Αυτό δεν είναι απαραίτητο για μεταφράσεις υπάρχοντος περιεχομένου)
-
Αν στέλνετε μεταφράσεις, και υπάρχει περίπτωση διορθώσεων από τρίτους, χρησιμοποιήστε αυτή τη δυνατότητα. Μπορείτε να απευθυνθείτε στον Κατάλογο μεταφραστών παραληπτών αλληλογραφίας για να ζητήσετε να γίνουν διορθώσεις. Ανεξάρτητα αν μεταφράζετε αρχεία ή τα διορθώνετε, σας ενθαρρύνουμε να κάνετε έλεγχο ορθογραφίας με χρήση αυτόματων εργαλείων, όπως τα GNU aspell, ispell, ή τον ορθογράφο της προτίμησής σας. Για παράδειγμα, για να χρησιμοποιήσετε το GNU aspell σε ένα σύστημα Debian GNU/Linux, απλά εγκαταστήσετε τα πακέτα
aspellκαιaspell-XX(όπου ''XX'' είναι ο αντίστοιχος γλωσσικός κώδικας), και εκτελέσετε την εντολήaspell -H -d language -c file.xhtml
(όπου ''language'' είναι το όνομα του λεξικού της γλώσσας στόχου· η επιλογή-dμπορεί να παραληφθεί αν το UNIX locale στον υπολογιστή σας είναι το ίδιο με τη γλώσσα του λεξικού). -
Βεβαιωθείτε ότι όλα τα αρχεία είναι κατάλληλα XML αρχεία. Υπάρχει ένα script που ονομάζεται
tools/validate.plτο οποίο βοηθάει στον εντοπισμό λαθών στα tags. Τα αντικανονικά XML διακόπτουν την αυτόματη διαδικασία κατασκευής των ιστοσελίδων και εμποδίζουν τις ενημερώσεις όλου του ιστοτόπου του FSFE. Αν υποπτεύεστε ότι η διαδικασία κατασκευής έχει πρόβλημα, μπορείτε να παρατηρήσετε το log της τελευταίας ανανέωσης εδώ.Το script
validate.plαπαιτεί τοXML::LibXMLPerl module· αν αυτό δεν έχει εγκατασταθεί στο σύστημά σας, μπορείτε να κάνετε έλεγχο αρχείων χρησιμοποιώντας τον XML ελεγκτή της προτίμησής σας. Για παράδειγμα μπορείτε να χρησιμοποιήσετε από τη γραμμή εντολών τη βοηθητική εντολήxmllintαπό το πρόγραμμα libxml2 (αν χρησιμοποιείτε τη διανομή Debian GNU/Linux, εγκαταστήστε το πακέτοlibxml2-utils)· εκτελέστε την εντολήxmllint --noout file.xhtml
και παρατηρήστε αν παράγονται μηνύματα λαθών. -
Βεβαιωθείτε ότι η κωδικοποίηση του αρχείου είναι συνεπής με το περιεχόμενο της παραμέτρου ''encoding'' η οποία δηλώνεται στην πρώτη γραμμή του αρχείου. Για παράδειγμα, αν το αρχείο σας έχει κωδικοποίηση ''iso-8859-1'' (επίσης γνωστή ως κωδικοποίηση ''latin-1''), η πρώτη γραμμή του αρχείου πρέπει να είναι
<?xml version="1.0" encoding="iso-8859-1" ?>
Μία άλλη αποδεκτή κωδικοποίηση είναι η unicode, ή "UTF-8" κωδικοποίηση. Αν θέλετε να αλλάξετε την κωδικοποίηση ενός αρχείου, μπορείτε να χρησιμοποιήσετε την τυπική βοηθητική εντολήiconv, όπως στο ακόλουθο παράδειγμα (το οποίο μετατρέπει ένα αρχείο από ''latin1'' σε ''utf-8''):iconv -f LATIN1 -t UTF8 inputfile > outputfile
Παρακαλούμε να είστε σε συντονισμό με άλλα μέλη τα οποία επίσης έχουν πρόσβαση για αλλαγές στο CVS για να βεβαιωθείτε ότι οι προσφερόμενες μεταφράσεις και διορθώσεις από ανθρώπους χωρίς δικαίωμα πρόσβασης για αλλαγές, αντιγράφονται σωστά στον εξυπηρετητή αφού έχουν διορθωθεί. Φυσικά, θα σας παρακαλέσουμε να ελέγξετε αυτά τα αρχεία πριν τα στείλετε στον εξυπηρετητή, όπως ακριβώς ελέγχετε και τα δικά σας αρχεία.
Περισσότερες πληροφορίες
Δεδομένου ότι ο ιστότοπος του FSFE έχει ένα ευρωπαϊκό/διεθνές επίπεδο και ότι τα τοπικά επίπεδα επιλογής των χρηστών συμπληρώνονται με πληροφορίες που ισχύουν ειδικά για συγκεκριμένες χώρες, η τελική διάταξη του κειμένου έχει μια ορισμένη πολυπλοκότητα η οποία αποκρύπτεται εντελώς από τον χρήστη της ιστοσελίδας.
Εκτός αν επιθυμείτε μόνο να μεταφράσετε σελίδες (δείτε παρακάτω), παρακαλούμε βεβαιωθείτε ότι έχετε δει την αναφορά στη δόμηση.
Επίσης, υπάρχει ένα Texinfo αρχείο τεκμηρίωσης "Webmastering FSF Europe" από τον Jonas Öberg, ο οποίος υλοποίησε το σύστημα κατασκευής σελίδων. Παρακαλούμε διαβάστε το και μάθετε περισσότερα για τη λειτουργία των σελίδων.
To top
