Κείμενο και μεταφράσεις¶

Το MRBS διαχωρίζει το λεξιλόγιο εφαρμογών, τη διατύπωση για συγκεκριμένο ιστότοπο, τις σελίδες βοήθειας και αυτό το εγχειρίδιο του MkDocs. Επιλέξτε το σωστό επίπεδο, ώστε οι αναβαθμίσεις να παραμένουν διαχειρίσιμες.

Εργασία	Κατάλληλη θέση
Μετονομάστε μια ετικέτα για μία εγκατάσταση	`$vocab_override` σε `config.inc.php`
Προσθέστε ή βελτιώστε μια γλώσσα διεπαφής χρήστη MRBS	`web/lang/lang.<language>`
Μεταφράστε ή προσαρμόστε τη σελίδα βοήθειας εντός της εφαρμογής	`web/site_faq/site_faq_<language>.html`
Μεταφράστε αυτό το εγχειρίδιο	Ένα αρχείο με επίθημα γλώσσας κάτω από `docs/`

Παράκαμψη διατύπωσης για έναν ιστότοπο¶

Μην επεξεργάζεστε ένα αρχείο γλώσσας της διανομής απλώς για να μετονομάσετε το "Room" ή να αλλάξετε τον τίτλο του ιστότοπου. Βρείτε το διακριτικό στο web/lang/lang.en και έπειτα παρακάμψτε το:

$vocab_override['en']['mrbs'] = 'Resource Booking';
$vocab_override['de']['mrbs'] = 'Ressourcenbuchung';
$vocab_override['fr']['mrbs'] = 'Réservation de ressources';
$vocab_override['es']['mrbs'] = 'Reserva de recursos';

Η σειρά των δεικτών είναι πάντοτε πρώτα η γλώσσα και έπειτα το διακριτικό: $vocab_override[LANG][TOKEN].

Τα χρήσιμα διακριτικά που ορίζονται από τον ιστότοπο περιλαμβάνουν:

$vocab_override['en']['room.coffee_machine'] = 'Coffee machine';
$vocab_override['en']['entry.catering'] = 'Catering';
$vocab_override['en']['entry.description.placeholder'] =
    'Add information for the room team';
$vocab_override['en']['users.zip_code.oninvalid'] =
    'Enter a valid ZIP code';
$vocab_override['en']['type.C'] = 'Customer booking';

Τα διακριτικά προσαρμοσμένων πεδίων περιγράφονται στο Προσαρμοσμένα πεδία. Οι περιγραφές τύπου κράτησης χρησιμοποιούν type.X, όπου X είναι ο διαμορφωμένος κωδικός τύπου.

Οι παρακάμψεις διατηρούνται κατά την αναβάθμιση, επειδή βρίσκονται στη διαμόρφωση του ιστότοπου. Ελέγξτε ξανά το νόημά τους αν μια νέα έκδοση αλλάξει το αρχικό διακριτικό ή το συμφραζόμενό του.

Διατηρήστε τους δείκτες αντικατάστασης¶

Οι συμβολοσειρές γλώσσας ενδέχεται να περιέχουν σύμβολα αντικατάστασης printf, όπως %s, %d, ή σύμβολα με αριθμημένη θέση, όπως %1$d. Διατηρήστε κάθε σύμβολο και τον τύπο του. Η μετάφραση μπορεί να αλλάξει τη σειρά των ορισμάτων μόνο όταν χρησιμοποιούνται αριθμημένες θέσεις.

Διατηρήστε επίσης τα σκόπιμα αποσπάσματα HTML, τη σημασία της στίξης και τα κενά στην αρχή ή στο τέλος. Όπου χρειάζεται, δοκιμάστε τις συμβολοσειρές για μηδενικό, ένα και περισσότερα στοιχεία.

Επιλέξτε τη γλώσσα χρόνου εκτέλεσης¶

Από προεπιλογή, το MRBS επιλέγει μια γλώσσα από το πρόγραμμα περιήγησης:

$disable_automatic_language_changing = false;

Για να αναγκάσετε μια γλώσσα:

$disable_automatic_language_changing = true;
$default_language_tokens = 'de';

Το διακριτικό πρέπει να αντιστοιχεί σε ένα διαθέσιμο αρχείο web/lang/lang.*. Η επιλογή τοπικών ρυθμίσεων για ημερομηνίες και ώρες μπορεί να παρακαμφθεί χωριστά:

$override_locale = 'de-DE';
$cli_language = 'de';

Το $override_locale πρέπει επίσης να υποστηρίζεται από το λειτουργικό σύστημα διακομιστή. Το $cli_language ελέγχει τις εντολές που εκτελούνται εκτός του προγράμματος περιήγησης. Για διάγνωση, το $language_debug = true γράφει πληροφορίες γλώσσας και τοπικής ρύθμισης στο αρχείο καταγραφής σφαλμάτων. απενεργοποιήστε το ξανά μετά την αντιμετώπιση προβλημάτων.

Προσθέστε ή διατηρήστε μια γλώσσα εφαρμογής¶

Το αγγλικό αρχείο αποτελεί την έκδοση αναφοράς και τη γλώσσα εφεδρείας. Για να δημιουργήσετε μια γλώσσα της οποίας το αναγνωριστικό είναι xx:

cp web/lang/lang.en web/lang/lang.xx

Τότε:

Διατηρήστε τη γραμμή ανοίγματος PHP και κάθε κλειδί $vocab.
Μεταφράστε τιμές συμβολοσειρών, όχι ονόματα διακριτικών.
Αποθηκεύστε το αρχείο ως UTF-8.
Μην χρησιμοποιείτε οντότητες HTML εκτός από το  . Γράφετε απευθείας χαρακτήρες UTF-8.
Διατηρήστε τους δείκτες αντικατάστασης και τη σκόπιμη σήμανση.
Επικυρώστε τη σύνταξη PHP.

php -l web/lang/lang.xx

Το MRBS φορτώνει πρώτα το αγγλικό αρχείο αναφοράς και έπειτα την επιλεγμένη γλώσσα. Επομένως, για όσα διακριτικά λείπουν εμφανίζεται το αγγλικό κείμενο.

Ελέγξτε την πληρότητα¶

Το checklang.php συγκρίνει τα αρχεία γλώσσας με το lang.en. Για παράδειγμα ανάπτυξης, τοποθετήστε ή διατηρήστε το στον κατάλογο ιστού MRBS και ανοίξτε:

https://example.invalid/mrbs/checklang.php?lang[]=xx

Χωρίς επιλογή γλώσσας, εμφανίζει όλα τα εγκατεστημένα αρχεία γλώσσας. Η προαιρετική λειτουργία ενημέρωσης τροποποιεί αρχεία και, επομένως, απαιτεί δικαιώματα εγγραφής. Αποφύγετέ την στην παραγωγή και ελέγχετε τις αλλαγές που δημιουργεί. Μετά την ολοκλήρωση του ελέγχου, περιορίστε την πρόσβαση σε αυτό το βοηθητικό πρόγραμμα ανάπτυξης ή αφαιρέστε το από τη δημόσια εγκατάσταση.

Ο έλεγχος σύνταξης και το checklang.php εντοπίζουν διαφορετικά προβλήματα· χρησιμοποιήστε και τα δύο.

Μεταφράστε τη σελίδα βοήθειας εντός της εφαρμογής¶

Το κείμενο βοήθειας δεν προέρχεται από το $vocab. Αποθηκεύεται χωριστά:

web/site_faq/site_faq.html
web/site_faq/site_faq_de.html
web/site_faq/site_faq_fr.html
web/site_faq/site_faq_es.html

Επιλέξτε το επίθημα χωρίς υπογράμμιση:

$faqfilelang = 'de';

Παλαιότερες τιμές όπως '_de' γίνονται δεκτές για συμβατότητα αλλά έχουν καταργηθεί. Η ρύθμιση είναι ανεξάρτητη από τη γλώσσα του προγράμματος περιήγησης, επομένως ελέγξτε ότι οι επιλεγμένες Συνήθεις Ερωτήσεις ταιριάζουν με το κοινό που θέλετε. Οι τοπικές τροποποιήσεις στα αποσταλμένα αρχεία Συχνών Ερωτήσεων πρέπει να καταγράφονται και να εφαρμόζονται εκ νέου ή να συγχωνεύονται κατά τη διάρκεια μιας αναβάθμισης.

Μεταφράστε αυτό το εγχειρίδιο¶

Ο ιστότοπος τεκμηρίωσης χρησιμοποιεί αρχεία καταλήξεων:

docs/admin-guide/custom-fields.md
docs/admin-guide/custom-fields.de.md
docs/admin-guide/custom-fields.fr.md
docs/admin-guide/custom-fields.es.md

Τα αγγλικά αποτελούν τη γλώσσα εφεδρείας της τεκμηρίωσης. Αυτά τα αρχεία δεν επηρεάζουν τη διεπαφή χρήστη της εφαρμογής MRBS ούτε τη σελίδα βοήθειας.

Ροή εργασιών ασφαλής για αναβάθμιση¶

Βάλτε τη διατύπωση μόνο για ιστότοπο στο $vocab_override.
Διατηρήστε μια λίστα με αρχεία γλώσσας και συχνών ερωτήσεων που διατηρούνται τοπικά.
Συγκρίνετε ένα νέο lang.en με την προηγούμενη έκδοση για πρόσθετα ή αλλαγμένα διακριτικά.
Εκτελέστε το php -l σε κάθε αρχείο αλλαγμένης γλώσσας.
Εκτελέστε το checklang.php σε μια παρουσία περιορισμένης ανάπτυξης.
Ελέγξτε τις αλλαγές συχνών ερωτήσεων ξεχωριστά.
Δοκιμάστε όλες τις ενεργές γλώσσες πριν από την ανάπτυξη.

Λίστα ελέγχου επαλήθευσης¶

Ο εντοπισμός του προγράμματος περιήγησης και η υποχρεωτική προεπιλογή επιλέγουν την αναμενόμενη γλώσσα.
Τα διακριτικά που λείπουν επανέρχονται σε κατανοητά αγγλικά.
Οι σελίδες πλοήγησης, φόρμες, σφάλματα, εγκρίσεις και διαχείριση αποδίδονται σωστά.
%s, %d και οι δείκτες θέσης λαμβάνουν τις σωστές τιμές.
Οι ημερομηνίες, οι ώρες, οι ημέρες της εβδομάδας και οι ζώνες ώρας χρησιμοποιούν τις προβλεπόμενες τοπικές ρυθμίσεις.
Τα θέματα και τα σώματα ηλεκτρονικού ταχυδρομείου, οι αναφορές, οι εξαγωγές και οι εργασίες γραμμής εντολών χρησιμοποιούν την προβλεπόμενη γλώσσα.
Μεταφράζονται τα προσαρμοσμένα πεδία, οι τύποι κράτησης, τα κείμενα υπόδειξης και τα μηνύματα επικύρωσης.
Η σελίδα Βοήθεια χρησιμοποιεί το αναμενόμενο αρχείο site_faq.
Τα αρχεία καταγραφής δεν περιέχουν μόνιμο εντοπισμό σφαλμάτων γλώσσας ή ευαίσθητες τιμές φόρμας.