Παράρτημα 3: Μετάφραση XOOPS σε τοπική γλώσσα

Το XOOPS 2.7.0 αποστέλλεται μόνο με αρχεία αγγλικής γλώσσας. Οι μεταφράσεις σε άλλες γλώσσες διατηρούνται από την κοινότητα και διανέμονται μέσω του GitHub και των διαφόρων τοπικών τοποθεσιών υποστήριξης XOOPS.

Πού θα βρείτε υπάρχουσες μεταφράσεις

• GitHub — οι μεταφράσεις της κοινότητας δημοσιεύονται όλο και περισσότερο ως ξεχωριστά αποθετήρια στον XOOPS οργανισμό και σε λογαριασμούς μεμονωμένων συνεργατών. Αναζητήστε το GitHub για XOOPS-language-<your-language> ή περιηγηθείτε στον οργανισμό XOOPS για τρέχοντα πακέτα.
• Τοπικοί XOOPS ιστότοποι υποστήριξης — πολλές περιφερειακές XOOPS κοινότητες δημοσιεύουν μεταφράσεις στους δικούς τους ιστότοπους. Επισκεφτείτε το https://XOOPS.org και ακολουθήστε τους συνδέσμους προς τις τοπικές κοινωνίες.
• Μεταφράσεις ενότητας — οι μεταφράσεις για μεμονωμένες μονάδες κοινότητας συνήθως βρίσκονται δίπλα στην ίδια τη λειτουργική μονάδα στον οργανισμό XoopsModules25x GitHub (το 25x στο όνομα είναι ιστορικό· οι ενότητες διατηρούνται εκεί και για τα XOOPS 2.5.x και 2).

Εάν υπάρχει ήδη μετάφραση για τη γλώσσα σας, αποθέστε τους καταλόγους γλωσσών στην εγκατάσταση XOOPS (δείτε “Πώς να εγκαταστήσετε μια μετάφραση” παρακάτω).

Τι πρέπει να μεταφραστεί

Το XOOPS 2.7.0 διατηρεί τα αρχεία γλώσσας δίπλα στον κώδικα που τα καταναλώνει. Μια πλήρης μετάφραση καλύπτει όλες αυτές τις τοποθεσίες:

• Πυρήνας — htdocs/language/english/ — σταθερές σε όλο τον ιστότοπο που χρησιμοποιούνται από κάθε σελίδα (σύνδεση, συνηθισμένα σφάλματα, ημερομηνίες, πρότυπα αλληλογραφίας κ.λπ.).
• Εγκαταστάτης — htdocs/install/language/english/ — συμβολοσειρές που εμφανίζονται από τον οδηγό εγκατάστασης. Μεταφράστε αυτά πριν εκτελέσετε το πρόγραμμα εγκατάστασης, εάν θέλετε μια τοπική εμπειρία εγκατάστασης.
• Μονάδα συστήματος — htdocs/modules/system/language/english/ — μακράν το μεγαλύτερο σύνολο. καλύπτει ολόκληρο τον Πίνακα Ελέγχου διαχειριστή.
• Μονάδες πακέτα — καθεμία από τις htdocs/modules/pm/language/english/, htdocs/modules/profile/language/english/, htdocs/modules/protector/language/english/ και htdocs/modules/debugbar/language/english/.
• Θέματα — μια χούφτα θέματα αποστέλλουν τα δικά τους αρχεία γλώσσας. ελέγξτε htdocs/themes/<theme>/language/ εάν υπάρχει.

Μια μετάφραση “μόνο πυρήνας” είναι η ελάχιστη χρήσιμη ενότητα και αντιστοιχεί στις δύο πρώτες κουκκίδες παραπάνω.

Πώς να μεταφράσετε

1. Αντιγράψτε τον κατάλογο english/ δίπλα του και μετονομάστε το αντίγραφο στη γλώσσα σας. Το όνομα του καταλόγου πρέπει να είναι το πεζό αγγλικό όνομα της γλώσσας (spanish, german, french, japanese, arabic, κ.λπ.).

   htdocs/language/english/    →    htdocs/language/spanish/

2. Ανοίξτε κάθε αρχείο .php στον νέο κατάλογο και μεταφράστε τις τιμές συμβολοσειράς μέσα στις κλήσεις define(). Μην αλλάζετε τα ονόματα των σταθερών — αναφέρονται από τον κώδικα PHP σε όλο τον πυρήνα.

   // Before:
   define('_CM_COMDELETED',  'Comment(s) deleted.');
   define('_CM_COMDELETENG', 'Could not delete comment.');
   define('_CM_DELETESELECT', 'Delete all its child comments?');

   // After (Spanish):
   define('_CM_COMDELETED',  'Comentario(s) eliminado(s).');
   define('_CM_COMDELETENG', 'No se pudo eliminar el comentario.');
   define('_CM_DELETESELECT', '¿Eliminar también todos sus comentarios secundarios?');

3. Αποθηκεύστε κάθε αρχείο ως UTF-8 χωρίς BOM. Το XOOPS 2.7.0 χρησιμοποιεί utf8mb4 από άκρο σε άκρο (βάση δεδομένων, συνεδρίες, μαρκάρισμα αρχείων ανά τεμάχιο) και απόρριψη. Στο Notepad++ αυτή είναι η επιλογή “UTF-8”, όχι “UTF-8-BOM”. Στο VS Code είναι η προεπιλογή. απλώς επιβεβαιώστε την κωδικοποίηση στη γραμμή κατάστασης.

4. Ενημερώστε τη γλώσσα και τα μεταδεδομένα συνόλου χαρακτήρων στο επάνω μέρος κάθε αρχείου για να ταιριάζει με τη γλώσσα σας:

   // _LANGCODE: es
   // _CHARSET : UTF-8
   // Translator: Your Name

Το _LANGCODE πρέπει να είναι ο ISO 639-1 κωδικός για τη γλώσσα σας. Το _CHARSET είναι πάντα UTF-8 στο XOOPS 2.7.0 — δεν υπάρχει πλέον παραλλαγή ISO-8859-1.

5. Επαναλάβετε για το πρόγραμμα εγκατάστασης, τη λειτουργική μονάδα συστήματος και τυχόν ομαδοποιημένες μονάδες που χρειάζεστε.

Πώς να εγκαταστήσετε μια μετάφραση

Εάν λάβατε μια ολοκληρωμένη μετάφραση ως δέντρο καταλόγου:

1. Αντιγράψτε κάθε κατάλογο <language>/ στον αντίστοιχο γονέα language/english/ στην εγκατάσταση XOOPS. Για παράδειγμα, αντιγράψτε το language/spanish/ στο htdocs/language/, το install/language/spanish/ στο htdocs/install/language/ και ούτω καθεξής.
2. Βεβαιωθείτε ότι η ιδιοκτησία και τα δικαιώματα του αρχείου είναι αναγνώσιμα από τον διακομιστή web.
3. Είτε επιλέξτε τη νέα γλώσσα κατά την εγκατάσταση (ο οδηγός σαρώνει τη htdocs/language/ για διαθέσιμες γλώσσες) ή, σε μια υπάρχουσα τοποθεσία, αλλάξτε τη γλώσσα στο Διαχειριστής → Σύστημα → Προτιμήσεις → Γενικές ρυθμίσεις.

Κοινή χρήση της μετάφρασής σας πίσω

Παρακαλούμε συνεισφέρετε τη μετάφρασή σας στην κοινότητα.

1. Δημιουργήστε ένα αποθετήριο GitHub (ή διαχωρίστε ένα υπάρχον αποθετήριο γλώσσας εάν υπάρχει για τη γλώσσα σας).
2. Χρησιμοποιήστε ένα σαφές όνομα όπως XOOPS-language-<language-code> (π.χ. XOOPS-language-es, XOOPS-language-pt-br).
3. Αντικατοπτρίστε τη δομή καταλόγου XOOPS μέσα στο αποθετήριο σας, ώστε τα αρχεία να ευθυγραμμίζονται με το σημείο όπου αντιγράφονται:

   xoops-language-es/
   ├── language/spanish/(files).php
   ├── install/language/spanish/(files).php
   └── modules/system/language/spanish/(files).php

4. Συμπεριλάβετε ένα README.md που να τεκμηριώνει:
   • Όνομα γλώσσας και κωδικός ISO
   • Συμβατότητα έκδοσης XOOPS (π.χ. XOOPS 2.7.0+)
   • Μεταφραστής και πιστώσεις
   • Είτε η μετάφραση είναι μόνο βασική είτε καλύπτει ομαδοποιημένες ενότητες
5. Ανοίξτε ένα αίτημα έλξης στο σχετικό αποθετήριο module/core στο GitHub ή δημοσιεύστε μια ανακοίνωση στο https://XOOPS.org για να το βρει η κοινότητα.

Σημείωση

Εάν η γλώσσα σας απαιτεί αλλαγές στον πυρήνα για τη μορφοποίηση ημερομηνίας ή ημερολογίου, συμπεριλάβετε αυτές τις αλλαγές και στο πακέτο. Γλώσσες με σενάρια από τα δεξιά προς τα αριστερά (αραβικά, εβραϊκά, περσικά, ουρντού) λειτουργούν αυθόρμητα στο XOOPS 2.7.0 — RTL υποστήριξη προστέθηκε σε αυτήν την έκδοση και μεμονωμένα θέματα το συλλέγουν αυτόματα.