Κατεβάστε τοOnlineΈκθεση

Οδηγός μετάφρασης

Εισαγωγή

Μιλάς μια ξένη γλώσσα που δεν υποστηρίζεται ακόμα στο Sweet Home 3D και θα ήθελες να συνεισφέρεις στη μετάφρασή του σε αυτή τη γλώσσα; Από την έκδοση 2.3, το Sweet Home 3D υποστηρίζει αρχεία SH3L και αυτός ο οδηγός θα σε μάθει πώς να δημιουργήσεις ένα τέτοιο αρχείο μόνος σου. Ένα αρχείο SH3L είναι ένα αυτο-εγκαταστάσιμο αρχείο γλώσσας και οι χρήστες απλά πρέπει να κάνουν διπλό κλικ σε ένα αρχείο SH3L για να μεταφράσουν το Sweet Home 3D στη γλώσσα που περιγράφεται από αυτό το αρχείο.

Βασικές οδηγίες

Η δημιουργία ενός αρχείου SH3L αποτελείται από:

  1. λήψη μιας αγγλικής έκδοσης των αρχείων προς μετάφραση,
  2. αποσυμπίεση του ληφθέντος αρχείου,
  3. προσθήκη ενός επιθήματος 2 γραμμάτων που αντιστοιχεί στη γλώσσα σου στα .properties αρχεία που περιέχει,
  4. μετάφραση του κειμένου στα .properties αρχεία,
  5. μετατροπή τους σε κωδικοποίηση ASCII,
  6. μετάφραση του κειμένου βοήθειας στα .html αρχεία (όχι υποχρεωτικό αλλά θα είναι πραγματικά χρήσιμο για τους χρήστες),
  7. συμπίεση των .properties αρχείων και των αρχείων βοήθειας πίσω σε ένα αρχείο με επέκταση SH3L,
  8. διπλό κλικ στο αρχείο SH3L για να δοκιμάσεις τη μετάφρασή σου στο Sweet Home 3D,
  9. διανομή του αρχείου SH3L σου.

Λεπτομερείς οδηγίες

Αν δεν φοβάσαι τις προηγούμενες βασικές οδηγίες, προχώρα με τα επόμενα βήματα.

Λήψη της αγγλικής έκδοσης

Κατέβασε το αρχείο στο https://www.sweethome3d.com/SweetHome3DTranslation.zip (έκδοση 7.5) και αποσυμπίεσέ το με τα εργαλεία του συστήματός σου.
Το SweetHome3DTranslation.zip περιέχει ένα σύνολο αρχείων με επεκτάσεις .properties και .html τοποθετημένα σε υποφακέλους όπως φαίνεται στην εικόνα 1.

Αρχεία μετάφρασης
Εικόνα 1. Αρχεία μετάφρασης

Όλα τα .properties και .html αρχεία περιέχουν την αγγλική έκδοση των κειμένων που θα πρέπει να μεταφράσεις στη γλώσσα σου:

Τα .properties αρχεία πρέπει να τοποθετηθούν στους φακέλους που φαίνονται στην εικόνα 1. διαφορετικά το Sweet Home 3D δεν θα μπορεί να τα χρησιμοποιήσει σωστά. Οπότε μην μετακινείς τα αρχεία έξω από το φάκελό τους, μην μετονομάζεις κανέναν φάκελο (εκτός από τον υποφάκελο en του help) και μην διαγράφεις κανέναν φάκελο.

Μετονομασία αρχείων ανάλογα με τη γλώσσα σου

Πριν μεταφράσεις τα .properties αρχεία, θα πρέπει να μετονομάσεις το καθένα προσθέτοντας στο όνομά του μια κάτω παύλα ακολουθούμενη από τον κωδικό ISO 2 χαρακτήρων που αντιστοιχεί στη γλώσσα σου. Θα βρεις αυτόν τον κωδικό στην τελευταία στήλη του εγγράφου https://www.loc.gov/standards/iso639-2/php/English_list.php.
Στη συνέχεια, αν θέλεις να μεταφράσεις τα αρχεία βοήθειας, θα πρέπει να μετονομάσεις επίσης τον υποφάκελο en του help με αυτόν τον κωδικό 2 γραμμάτων.
Για παράδειγμα, ο κωδικός ISO για τα Τσέχικα είναι cs. Αν θέλεις να μεταφράσεις το Sweet Home 3D στα Τσέχικα, κάθε όνομα αρχείου θα πρέπει να έχει το επίθημα _cs, και θα πρέπει να μετονομάσεις τα αρχεία όπως φαίνεται στην εικόνα 2.

Οδηγός μετάφρασης
Εικόνα 2. Αρχεία ιδιοτήτων με το επίθημα του κωδικού ISO

Μετάφραση αρχείων ιδιοτήτων

Τα .properties αρχεία είναι απλά αρχεία κειμένου και μπορείς να τα επεξεργαστείς με οποιονδήποτε επεξεργαστή κειμένου όπως το Wordpad, το TextEdit ή το emacs. Για παράδειγμα, το αρχείο com/eteks/sweethome3d/package.properties στο Sweet Home 3D 3.0 περιέχει το ακόλουθο κείμενο:

# package.properties 10 oct. 2007
# 
# Copyright (c) 2024 Space Mushrooms <[email protected]>. All Rights Reserved.
# 
# This program is free software; you can redistribute it and/or modify it under
# the terms of the GNU General Public License as published by the Free Software
# Foundation; either version 2 of the License, or (at your option) any later
# version.
# 
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
# FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
# details.
# 
# You should have received a copy of the GNU General Public License along with
# this program; if not, write to the Free Software Foundation, Inc., 59 Temple
# Place, Suite 330, Boston, MA 02111-1307 USA

# Πόροι για την κλάση HomeFramePane
HomeFramePane.untitled=Χωρίς τίτλο


# Πόροι για την κλάση MacOSXConfiguration
MacOSXConfiguration.WINDOW_MENU.Name=Παράθυρο
MacOSXConfiguration.MINIMIZE.Name=Ελαχιστοποίηση
MacOSXConfiguration.ZOOM.Name=Μεγέθυνση
MacOSXConfiguration.BRING_ALL_TO_FRONT.Name=Μεταφορά όλων μπροστά


# Πόροι για την κλάση SweetHome3D
SweetHome3D.3DError.message=<html> Το Sweet Home 3D θα τερματιστεί τώρα λόγω ενός κρίσιμου σφάλματος
    <br>στο σύστημα απόδοσης 3D. Παρακαλώ ενημερώστε τους οδηγούς DirectX/OpenGL
    <br>της κάρτας γραφικών του υπολογιστή σας. 
SweetHome3D.3DError.title=Σφάλμα 3D
    
SweetHome3D.confirmSaveAfter3DError.message=<html> Το Sweet Home 3D πρέπει να τερματιστεί τώρα λόγω ενός κρίσιμου σφάλματος στο
    <br>σύστημα απόδοσης 3D. Θέλετε να αποθηκεύσετε όλα τα τροποποιημένα σπίτια; 
SweetHome3D.confirmSaveAfter3DError.title=Σφάλμα 3D
SweetHome3D.confirmSaveAfter3DError.save=Αποθήκευση
SweetHome3D.confirmSaveAfter3DError.doNotSave=Να μην αποθηκευτεί

Ένα .properties αρχείο περιέχει τρία είδη γραμμών:

Ειδικές περιπτώσεις:

Μετατροπή αρχείων ιδιοτήτων σε κωδικοποίηση ASCII

Αν μετέφρασες κείμενα σε γλώσσα με γράμματα που δεν ανήκουν στην κωδικοποίηση ISO-8859-1 (κυρίως γλώσσες της Κεντρικής και Ανατολικής Ευρώπης και γλώσσες με μη λατινικό αλφάβητο), θα πρέπει να μετατρέψεις όλα τα αρχεία .properties σε κωδικοποίηση ASCII που υποστηρίζεται από το Sweet Home 3D. Αυτή η μετατροπή μπορεί να γίνει με το εργαλείο native2ascii που παρέχεται με το JDK ή μπορεί να πραγματοποιηθεί με την ακόλουθη φόρμα.
Για κάθε αρχείο .properties, δημιούργησε ένα αντίγραφο ασφαλείας, αντέγραψε/επικόλλησε το κείμενο προς μετατροπή στην παρακάτω περιοχή κειμένου, κάνε κλικ στο κουμπί Μετατροπή και αντέγραψε/επικόλλησε το μετατρεπόμενο κείμενο πίσω στο αρχείο .properties.

Το εργαλείο μετατροπής θα αντικαταστήσει κάθε μη ASCII χαρακτήρα (τονισμένα λατινικά γράμματα και μη λατινικά γράμματα) με μια ακολουθία που ξεκινά με \u και ακολουθείται από έναν 4ψήφιο δεκαεξαδικό κωδικό που αντιστοιχεί σε αυτόν τον χαρακτήρα στο Unicode. Δυστυχώς, αυτή η μετατροπή θα κάνει το κείμενό σου αρκετά δυσανάγνωστο για έναν άνθρωπο, αλλά αν δεν την κάνεις, το Sweet Home 3D δεν θα μπορεί να εμφανίσει σωστά τους χαρακτήρες της μετάφρασής σου. Γι’ αυτό το λόγο πρέπει να δημιουργήσεις αντίγραφο ασφαλείας των αρχικών αρχείων .properties, σε περίπτωση που θέλεις να τα αλλάξεις αργότερα.
Αν θέλεις να επεξεργαστείς απευθείας αρχεία .properties που έχουν μετατραπεί σε ASCII, μπορείς επίσης να χρησιμοποιήσεις την εφαρμογή Properties Editor που είναι διαθέσιμη ως εκτελέσιμο αρχείο Jar εδώ.

Μετάφραση των αρχείων βοήθειας

Μια καλή μετάφραση του Sweet Home 3D θα πρέπει επίσης να περιλαμβάνει τη μετάφραση των αρχείων βοήθειας. Η μετάφραση όλων των αρχείων .html είναι μια χρονοβόρα εργασία, αλλά θα βοηθήσει πραγματικά τους χρήστες να μάθουν το λογισμικό και να αποφύγουν κάποια αιτήματα υποστήριξης στο φόρουμ του Sweet Home 3D. Χρησιμοποίησε οποιονδήποτε επεξεργαστή HTML για να μεταφράσεις αυτά τα αρχεία, προσπαθώντας να διατηρήσεις τους συνδέσμους που περιέχει και το φύλλο στυλ του αμετάβλητο.
Μόλις μεταφραστούν, θα πρέπει επίσης να δημιουργήσεις στιγμιότυπα οθόνης των παραθύρων διαλόγου στη γλώσσα σου για να αντικαταστήσεις τις εικόνες που βρίσκονται στο com/eteks/sweethome3d/viewcontroller/resources/help/en/images. Για να μπορέσεις να δημιουργήσεις τέτοια στιγμιότυπα οθόνης, δημιούργησε και δοκίμασε ένα πρώτο αρχείο SH3L με τα ακόλουθα βήματα (μόλις υπάρξει ένα αρχείο SH3L που περιέχει μεταφρασμένα αρχεία .properties, μπορείς επίσης να ζητήσεις από τον προγραμματιστή του Sweet Home 3D να δημιουργήσει τα στιγμιότυπα οθόνης).

Δημιουργία του αρχείου SH3L

Μόλις μεταφραστούν όλα τα αρχεία .properties και .html και μετατραπούν σε ASCII αν χρειάζεται (ή ακόμα και πριν αν θέλεις να δοκιμάσεις αυτή τη διαδικασία), θα πρέπει να τα συμπιέσεις σε ένα αρχείο zip. Ανάλογα με το σύστημά σου, η δημιουργία ενός αρχείου zip μπορεί να γίνει με την ακόλουθη διαδικασία:

Τέλος, άλλαξε την επέκταση .zip του αρχείου zip σε .sh3l. Ένα αρχείο SH3L μπορεί να έχει οποιοδήποτε όνομα, αλλά για να αποφύγεις συγκρούσεις με υπάρχοντα αρχεία SH3L, θα πρέπει να το ονομάσεις με βάση τη γλώσσα που περιέχει και την έκδοση του Sweet Home 3D που μετέφρασες (για παράδειγμα, το French-4.1.sh3l θα μπορούσε να είναι ένα καλό όνομα για τη γαλλική μετάφραση του Sweet Home 3D 4.1).

Δοκιμή ενός αρχείου SH3L

Για να δοκιμάσεις τη μετάφραση, κάνε διπλό κλικ σε ένα αρχείο SH3L ή επίλεξέ το με το κουμπί Εισαγωγή αρχείου βιβλιοθήκης γλώσσας που εμφανίζεται στο πάνω μέρος του παραθύρου Προτιμήσεις. Αυτό θα εκκινήσει το Sweet Home 3D και θα μεταφράσει το περιβάλλον χρήστη στη γλώσσα που περιγράφεται στο αρχείο SH3L. Αυτό θα αντιγράψει επίσης το αρχείο SH3L σε ένα φάκελο ανάλογα με το σύστημά σου:

Σημείωσε επίσης ότι κατά τη διάρκεια της ανάπτυξης του αρχείου SH3L, πιθανόν να χρειαστεί να επανεκκινήσεις το Sweet Home 3D για να δεις τις αλλαγές στο αρχείο SH3L.

Διανομή αρχείων SH3L

Μόλις το αρχείο SH3L σου είναι έτοιμο, μπορείς να το προτείνεις σε οποιονδήποτε, να το ανακοινώσεις στους χρήστες του Sweet Home 3D στο τμήμα του φόρουμ που είναι αφιερωμένο στις ξένες γλώσσες ή σε άλλα μέρη. Αν συμφωνείς, μπορεί να γίνει διαθέσιμο σε αυτόν τον ιστότοπο στη σελίδα σχετικά με τις μεταφράσεις που υποστηρίζονται από το Sweet Home 3D.

Ενημέρωση αρχείων SH3L

Κάποιες εκδόσεις του Sweet Home 3D φέρνουν νέα χαρακτηριστικά προς μετάφραση, κάποιες όχι. Αν δεν μεταφράσεις τις ετικέτες διεπαφής χρήστη που αντιστοιχούν σε αυτά τα νέα χαρακτηριστικά, το Sweet Home 3D θα λειτουργεί αλλά όλες οι νέες ετικέτες θα εμφανίζονται στα Αγγλικά. Για να βρεις τα νέα κλειδιά και τα ενημερωμένα κλειδιά στα αρχεία .properties, μπορείς να χρησιμοποιήσεις μια λειτουργία που προσφέρει το SourceForge.net που σου επιτρέπει να συγκρίνεις δύο εκδόσεις ενός αρχείου έργου:

  1. Αναζήτησε τις ημερομηνίες των εκδόσεων του Sweet Home 3D που θέλεις να συγκρίνεις στο ιστορικό (για παράδειγμα, 19 Ιουλίου 2015 για την έκδοση 5.0 και 2 Φεβρουαρίου 2015 για την έκδοση 4.6)
  2. Κάνε κλικ στο αρχείο .properties ή .html που θέλεις να ενημερώσεις στην εικόνα 1,
  3. Επίλεξε τα δύο πλαίσια ελέγχου του αριθμού αναθεώρησης που αντιστοιχεί στην ημερομηνία έκδοσης για το ενημερωμένο αρχείο, επιλέγοντας την ημερομηνία που είναι ακριβώς πριν από μια ημερομηνία έκδοσης του Sweet Home 3D,
  4. Κάνε κλικ στο κουμπί Σύγκριση.

Το τελευταίο κλικ θα σου δείξει τις διαφορές μεταξύ των δύο εκδόσεων αυτού του αρχείου .properties (για παράδειγμα, αυτός ο σύνδεσμος θα σου δείξει τις διαφορές μεταξύ της έκδοσης 4.6 και της έκδοσης 5.0 του αρχείου com/eteks/sweethome3d/viewcontroller/package.properties).

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