mirror of
https://github.com/onionshare/onionshare.git
synced 2024-10-01 01:35:40 -04:00
250 lines
7.5 KiB
Plaintext
250 lines
7.5 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) Micah Lee, et al. Like all software, OnionShare may contain
|
|
# bugs or vulnerabilities.
|
|
# This file is distributed under the same license as the OnionShare package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2020.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: OnionShare 2.3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2020-08-26 20:38-0700\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Generated-By: Babel 2.8.0\n"
|
|
|
|
#: ../../source/develop.rst:2
|
|
msgid "Developing OnionShare"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:7
|
|
msgid "Collaborating"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:9
|
|
msgid ""
|
|
"OnionShare has an open Keybase team that we use to discuss the project, "
|
|
"including asking questions, sharing ideas and designs, and making plans "
|
|
"for future development. (It's also an easy way to send end-to-end "
|
|
"encrypted direct messages to others in the OnionShare community, like "
|
|
"OnionShare addresses.) To use Keybase, you need to download the `Keybase "
|
|
"app <https://keybase.io/download>`_, make an account, and `join this team"
|
|
" <https://keybase.io/team/onionshare>`_. Within the app, go to Teams, "
|
|
"click \"Join a Team\", and type \"onionshare\"."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:11
|
|
msgid ""
|
|
"OnionShare also has a `mailing list "
|
|
"<https://lists.riseup.net/www/subscribe/onionshare-dev>`_ for developers "
|
|
"and and designers to discuss the project."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:14
|
|
msgid "Contributing code"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:16
|
|
msgid ""
|
|
"OnionShare source code is in this git repository: "
|
|
"https://github.com/micahflee/onionshare"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:18
|
|
msgid ""
|
|
"If you'd like to contribute code to OnionShare, it helps to join the "
|
|
"Keybase team and ask questions about what you're thinking of working on. "
|
|
"You should also review all of the `open issues "
|
|
"<https://github.com/micahflee/onionshare/issues>`_ on GitHub to see if "
|
|
"there are any that you'd like to develop."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:20
|
|
msgid ""
|
|
"When you're ready to contribute code, open a pull request in the GitHub "
|
|
"repository and one of the project maintainers will review it and possible"
|
|
" ask questions, request changes, reject it, or merge it into the project."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:23
|
|
msgid "Starting development"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:25
|
|
msgid ""
|
|
"OnionShare is developed in Python. To get started, you should close the "
|
|
"git repository at https://github.com/micahflee/onionshare/ and then "
|
|
"consult the ``BUILD.md`` file."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:27
|
|
msgid "That file contains the technical instructions and commands necessary:"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:29
|
|
msgid "Install dependencies for your platform"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:30
|
|
msgid "Run OnionShare from the source tree, without building a package"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:31
|
|
msgid "Building packages"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:32
|
|
msgid "Making a release of OnionShare"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:35
|
|
msgid "Debugging tips"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:38
|
|
msgid "Verbose mode"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:40
|
|
msgid ""
|
|
"When developing, it's convenient to run OnionShare from a terminal and "
|
|
"add the ``--verbose`` (or ``-v``) flag to the command. This will print a "
|
|
"lot of helpful messages to the terminal such as when certain objects are "
|
|
"initialized, when events occur (like buttons clicked, settings saved or "
|
|
"reloaded), and other debug information. For example::"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:120
|
|
msgid ""
|
|
"You can add your own debug messages by running the ``Common.log`` method "
|
|
"from ``onionshare/common.py``. For example::"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:124
|
|
msgid ""
|
|
"This can be useful when learning the chain of events that occur when "
|
|
"using the application or the value of certain variables before and after "
|
|
"they are manipulated."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:127
|
|
msgid "Local only"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:129
|
|
msgid ""
|
|
"Tor is slow, and it's often convenient to skip starting onion services "
|
|
"altogether during development. You can do this with the ``--local-only`` "
|
|
"flag. For example::"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:166
|
|
msgid ""
|
|
"In this case, you load the URL ``http://onionshare:eject-"
|
|
"snack@127.0.0.1:17614`` in a normal web browser like Firefox, instead of "
|
|
"using Tor Browser."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:169
|
|
msgid "Debugging in Windows"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:171
|
|
msgid ""
|
|
"If you want to obtain debug output from the ``onionshare-gui.exe`` in "
|
|
"Windows, you will need to edit ``install\\pyinstaller.spec`` and change "
|
|
"``console=False`` to ``console=True``."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:173
|
|
msgid ""
|
|
"Then rebuild the EXE with ``install\\build_exe.bat`` (you may need to "
|
|
"comment out the ``signtool`` commands in the ``build_exe.bat`` and the "
|
|
"``onionshare.nsi`` files, as per the ``BUILD.md`` instructions)."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:175
|
|
msgid ""
|
|
"After this, you can run ``onionshare-gui.exe -v`` from a command prompt "
|
|
"to see the debug output."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:178
|
|
msgid "Contributing translations"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:180
|
|
msgid ""
|
|
"Most of the OnionShare is translatable. You can help make it easier to "
|
|
"use and more familiar and welcoming for people around the globe. The "
|
|
"Localization Lab has some `documentation about translating OnionShare "
|
|
"<https://wiki.localizationlab.org/index.php/OnionShare>`_."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:182
|
|
msgid ""
|
|
"OnionShare uses Weblate to keep track of translations. You can view the "
|
|
"OnionShare project here: https://hosted.weblate.org/projects/onionshare/"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:184
|
|
msgid ""
|
|
"To help translate, make a Hosted Weblate account and start contributing "
|
|
"to that project."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:187
|
|
msgid "Suggestions for original English strings"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:189
|
|
msgid ""
|
|
"Sometimes the original English strings could be improved, making them "
|
|
"easier to translate into other languages."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:191
|
|
msgid ""
|
|
"If you have suggestions for a better English string, please open a GitHub"
|
|
" issue rather than commenting in Weblate. This ensures the upstream "
|
|
"developers will definitely see the suggestion, and can potentially modify"
|
|
" the string via the usual code review processes."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:194
|
|
msgid "Status of translations"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:195
|
|
msgid ""
|
|
"Here is the current translation status. If you want start a translation "
|
|
"in a language not to be found here, please write us to the mailing list: "
|
|
"onionshare-dev@lists.riseup.net"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:200
|
|
msgid "Translate the .desktop file"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:202
|
|
msgid "You can also translate the ``install/onionshare.desktop`` file."
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:204
|
|
msgid ""
|
|
"Duplicate the line that begins with ``Comment=``. Add the language code "
|
|
"to the new line so it becomes ``Comment[lang]=`` (lang should be your "
|
|
"language). You can see what language codes are used for translation by "
|
|
"looking at the ``share/locale/*.json`` filenames::"
|
|
msgstr ""
|
|
|
|
#: ../../source/develop.rst:209
|
|
msgid "Do the same for other untranslated lines."
|
|
msgstr ""
|
|
|