Zaangażowanie się w calibre
The secret of calibre's success is its vibrant user community. Users have contributed code and become developers, translations to make calibre available in different languages, graphics to improve its look and feel and of course thousands of bug reports to help make it the robust piece of software it is today. An incomplete list of contributors to calibre is available here.
Dołącz do społeczności calibreAby porozmawiać z innymi użytkownikami calibre i być na bieżąco z najnowszymi osiągnięciami w świecie calibre, możesz użyć kilku narzędzi:
- The calibre user forum
- #calibre on Twitter
- The calibre Facebook page
- The calibre new releases RSS feed
Tworzenie wtyczki calibre
calibre has a comprehensive plugin interface, that allows the creation of plugins that can do just about anything. For many examples, see the calibre Plugins forum. A tutorial on getting started with plugin development, is available.
Przyczynianie się do tłumaczeń do calibre
calibre has support for translating its user interface. You can see the list of languages for which translations exist here. If the translations for your language are incomplete/missing, you can contribute the translations using a simple web-based interface. To do so first create an account in Transifex, then click on your language in this page. Click on the "Join Team" button. Once you have been approved, simply click on the language you want to translate here and use the "Translate Now" button to contribute your translations.
Alternatively you can download the PO file to do your translations offline by using the "Download for translation" link instead of the "Translate Now" button. You can edit the PO file using your favorite translation software and when you are done, upload the file by clicking the "Upload file" link (which is just below the "Download for translation" link).
Najczęściej zadawane pytania dotyczące tłumaczeń
- What to do with the & symbols?
The & symbols denote a keyboard shortcut. So for example the string "&Title" means that the corresponding GUI element can be accessed with the keyboard shortcut "Alt+T" (this only works on Windows/Linux). So in your translation leave the & symbol before the same letter if possible, or some other suitable letter.
- What to do with the "%A_Word" characters?
The % character and a word to the right of it (no space between the percentage sign and the word), denotes a word that will be replaced by the code. So when encountering this symbol and a word right next to it (example: %default), don't change it. Keep it as is in the translated sentence. Similarly for sequences like %s or %d, leave them as is. Finally, sequences like %(some_word)s should also be left unchanged.
- What to do with
These are placeholders and must not be translated. They will be replaced with actual content by the code.
- Co zrobić z ciągami dat, takimi jak dd MM rrrr?
Nie należy ich tłumaczyć.
- What to do with the special markup when translating the User Manual?
The User Manual is written in reStructuredText. You will see many constructs like
:guilabel:`Some text`. Here the
:guilabel:``part is markup, like HTML tags. You should only translate the text within the backticks. Particular care must be taken with links, of the following forms:
:ref:`some text`Here nothing must be translated.
:ref:`Some text <link-location>`Here only "Some text" must be translated.
``Some text``This is a literal and nothing should be translated in it.
:doc:`generated/en/something`Should be replaced by :doc:`generated/your_language_code/something`. For example
- How do I test my translations?
First you need to download a .po file for your language from here. You can test your .po file by setting the environment variable CALIBRE_TEST_TRANSLATION to the path of the downloaded .po file. Then run calibre as normal. Currently, it is not possible to test the User Manual translations.
Zostań współtwórcą calibre
git clone git://github.com/kovidgoyal/calibre.git
Lub jeśli nie chcesz czekać na pobranie pełnej historii wersji, możesz pobrać tylko kod źródłowy:
curl -L http://code.calibre-ebook.com/dist/src | tar xvJ
Instructions for getting calibre to run using your source checkout, as well as some info about how the calibre code is organized is in the User Manual.
If you come up with a cool idea and a patch for implementing it, let us know about it and more than likely it will be in the next weekly calibre release. A great place to ask for tips on calibre hacking is the calibre Development forum where lots of calibre developers hang out.