Βοηθητικά σενάρια κελύφους

Έκδοση: 1.7.0
Ημερομηνία: 27/07/09

Κατά τη διαχείριση του χώρου του SVN KDE της ομάδας, παρουσιάστηκε η ανάγκη «αυτοματοποίησης» κάποιων επαναλαμβανόμενων εργασιών. Η προσφορότερη λύση ήταν η δημιουργία μίας σειράς σεναρίων κελύφους, τα οποία είναι πλέον διαθέσιμα για χρήση στο φάκελο scripts του ftp χώρου της ομάδας. Τα περιεχόμενα του φακέλου παρουσιάζονται παρακάτω.

• Αρχείο instructions.txt
  Περιέχει οδηγίες για την εγκατάσταση των σεναρίων κελύφους.
  
  
• Αρχείο install.sh
  Αρχείο εγκατάστασης.
  
  
• Αρχείο l10n.conf
  Είναι το αρχείο ρυθμίσεων για τα σενάρια κελύφους. Περιέχει μια σειρά παραμέτρων και κάποιες ενδεικτικές τιμές.
  
  ΠΡΟΣΟΧΗ: Το αρχείο θα πρέπει να αποθηκευτεί ως ~/.l10n.conf
  
  
• Αρχείο l10n-common
  Περιέχει κάποιες υπορουτίνες που χρησιμοποιούνται από τα σενάρια κελύφους.
  
  
• Σενάριο κελύφους l10n-up
  Κάνει ανανέωση και των δύο κλάδων του τοπικού αντιγράφου του SVN KDE.
  
  
• Σενάριο κελύφους l10n-ci
  Κάνει υποβολή (commit) των αλλαγών και των δύο κλάδων του τοπικού αντιγράφου του SVN KDE.
  Πριν την υποβολή των αλλαγών, ελέγχει και προσθέτει (svn add) τα νέα αρχεία στο SVN KDE. Τέλος δημουργεί ένα αρχείο καταγραφής με όνομα l10n-ci-<ημερομηνία-ώρα>.log στο φάκελο προσωρινής αποθήκευσης.
  
  
• Σενάριο κελύφους l10n-st
  Εμφανίζει την κατάσταση (status) και των δύο κλάδων του τοπικού αντιγράφου του SVN KDE.
  
  
• Σενάριο κελύφους l10n-stats
  Υπολογίζει στατιστικά των αρχείων po.
  Υπάρχει η δυνατότητα υπολογισμού συγκεντρωτικών στατιστικών στοιχείων ενός module, ενός ολόκληρου κλάδου, συγκεκριμένων modules ενός κλάδου κλπ.
  
  
• Σενάριο κελύφους l10n-merge  Ενημερώθηκε 
  Κάνει συγχώνευση (merge) ενός νέου αρχείου po σε έναν από τους δύο κλάδους.
  
  
• Σενάριο κελύφους l10n-search
  Αναζητά μία συμβολοσειρά σε αρχεία po.
  Υπάρχει η δυνατότητα αναζήτησης σε όλα τα αρχεία po ενός κλάδου, με ή χωρίς τη χρήση κανονικής έκφρασης για τον προς αναζήτηση όρο.
  
  
• Σενάριο κελύφους l10n-replace
  Αντικαθιστά μία συμβολοσειρά σε αρχεία po.
  Και εδώ υπάρχει η δυνατότητα αναζήτησης σε όλα τα αρχεία po ενός κλάδου. Η αναζήτηση του προς αντικατάσταση όρου γίνεται με διάκριση πεζών/κεφαλαίων.
  
  ΠΡΟΣΟΧΗ: Για τη συμβολοσειρές αναζήτησης και αντικατάστασης θα πρέπει να χρησιμοποιηθεί σύνολο χαρακτήρων utf-8, αφού αυτή είναι η κωδικοποίηση που χρησιμοποιείται στα αρχεία po.
  
  
• Σενάριο κελύφους l10n-find-new
  Εντοπίζει νέα αρχεία pot στο τοπικό αντίγραφο του SVN repository.
  Δημιουργούνται τα αντίστοιχα αρχεία po, χωρίς να έχουν υποστεί καμία επεξεργασία, και αν ο χρήστης έχει άδεια για υποβολή αρχείων, προστίθενται (svn add) στο KDE SVN.
  
  Οι ενέργειες του σεναρίου κελύφους καταγράφονται στο αρχείο "$tmpFolder"/auto-actions.log
  Ο φάκελος εργασίας "$tmpFolder" δηλώνεται στο αρχείο l10n.conf
  
  ΠΡΟΣΟΧΗ: Τα αρχεία po, κατά τη δημιουργία τους, δεν αρχικοποιούνται, πράγμα που σημαίνει ότι ο μεταφραστής θα πρέπει να τα επεξεργαστεί (π.χ. με το kbabel) πριν αυτά περαστούν στο KDE SVN, με την επόμενη υποβολή αρχείων (svn commit).
  
  
• Σενάριο κελύφους l10n-find-deleted
  Εντοπίζει αρχεία pot που έχουν αφαιρεθεί από το KDE SVN.
  Τα αντίστοιχα αρχεία po διαγράφονται από το τοπικό αντίγραφο του repository, αφού πρώτα αντιγραφούν στο φάκελο "$tmpFolder"/deleted_from_svn. Aν ο χρήστης έχει άδεια για υποβολή αρχείων, αφαιρούνται (svn remove) και από το KDE SVN.
  
  Οι ενέργειες του σεναρίου κελύφους καταγράφονται στο αρχείο "$tmpFolder"/auto-actions.log
  Ο φάκελος εργασίας "$tmpFolder" δηλώνεται στο αρχείο l10n.conf
  
  
• Σενάριο κελύφους l10n-chpo
  To σενάριο αυτό παρέχει τη δυνατότητα συντακτικού ελέγχου ενός αρχείου, ενός κλάδου ή και ολόκληρου του τοπικού αντιγράφου του KDE SVN.
  
  Οι έλεγχοι που μορούν να εκτελεστούν είναι (με τη χρήση κατάλληλων παραμέτρων): έλεγχος μορφής, έλεγχος κεφαλίδας, έλεγχος πλήκτρων συντόμευσης πληκτρολογίου. Επίσης είναι δυνατή η εμφάνιση των στατιστικών ενός αρχείου po.
  
  Προσοχή: Η αναφορά σφαλμάτων κατά τον έλεγχο πλήκτρων συντόμευσης πληκτρολογίου, δεν είναι πάντα σωστή (λόγω ασυμβατότητας του πακέτου gettext και της μορφής των αρχείων που χρησιμοποιούνται στο KDE). Για το λόγο αυτό, η αναφορά τέτοιων σφαλμάτων θα πρέπει να αντιμετωπίζεται απλώς ως αναφορά πιθανού σφάλματος.

Σενάρια κελύφους για ενημέρωση του ιστότοπου

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

• Σενάριο κελύφους l10n-html-tidy  Νέο 
  Χρησιμοποιεί το HTML Tidy για να φορμάρει «σωστά» τα αρχεία HTML που βρίσκονται στον κατάλογο στον οποίο εκτελείται.
  
  
• Σενάριο κελύφους l10n-html-branch  Νέο 
  Αλλάζει τον ενεργό κλάδο εργασίας.
  
  
• Σενάριο κελύφους l10n-html-stats
  Δημιουργεί τις σελίδες στατιστικών του ιστότοπου.
  
  
• Σενάριο κελύφους l10n-html-list
  Δημιουργεί τις σελίδες απόδωσης όρων του ιστότοπου.

Μπορείτε να κατεβάσετε όλα τα αρχεία σε συμπιεσμένη μορφή από εδώ: l10n-scripts.tar.bz2.

Για σχόλια - παρατηρήσεις, παρακαλώ επικοινωνήστε με το συντηρητή των σεναρίων κελύφους.