Build docs

This commit is contained in:
Micah Lee 2021-09-09 19:50:11 -07:00
parent 9e4df9c8e0
commit e0c74b705e
No known key found for this signature in database
GPG key ID: 403C2657CD994F73
61 changed files with 4580 additions and 2796 deletions

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-05-03 21:48-0700\n"
"POT-Creation-Date: 2021-09-09 19:49-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"
@ -45,7 +45,7 @@ msgstr ""
msgid ""
"When you quit OnionShare and then open it again, your saved tabs will "
"start opened. You'll have to manually start each service, but when you do"
" they will start with the same OnionShare address and password."
" they will start with the same OnionShare address and private key."
msgstr ""
#: ../../source/advanced.rst:21
@ -55,32 +55,35 @@ msgid ""
msgstr ""
#: ../../source/advanced.rst:26
msgid "Turn Off Passwords"
msgid "Turn Off Private Key"
msgstr ""
#: ../../source/advanced.rst:28
msgid ""
"By default, all OnionShare services are protected with the username "
"``onionshare`` and a randomly-generated password. If someone takes 20 "
"wrong guesses at the password, your onion service is automatically "
"stopped to prevent a brute force attack against the OnionShare service."
"By default, all OnionShare services are protected with a private key, "
"which Tor calls \"client authentication\"."
msgstr ""
#: ../../source/advanced.rst:31
#: ../../source/advanced.rst:30
msgid ""
"When browsing to an OnionShare service in Tor Browser, Tor Browser will "
"prompt for the private key to be entered."
msgstr ""
#: ../../source/advanced.rst:32
msgid ""
"Sometimes you might want your OnionShare service to be accessible to the "
"public, like if you want to set up an OnionShare receive service so the "
"public can securely and anonymously send you files. In this case, it's "
"better to disable the password altogether. If you don't do this, someone "
"can force your server to stop just by making 20 wrong guesses of your "
"password, even if they know the correct password."
"better to disable the private key altogether."
msgstr ""
#: ../../source/advanced.rst:35
msgid ""
"To turn off the password for any tab, just check the \"Don't use a "
"password\" box before starting the server. Then the server will be public"
" and won't have a password."
"To turn off the private key for any tab, check the \"This is a public "
"OnionShare service (disables private key)\" box before starting the "
"server. Then the server will be public and won't need a private key to "
"view in Tor Browser."
msgstr ""
#: ../../source/advanced.rst:40
@ -133,93 +136,61 @@ msgstr ""
msgid ""
"**Scheduling an OnionShare service to automatically stop can be useful to"
" limit exposure**, like if you want to share secret documents while "
"making sure they're not available on the Internet for more than a few "
"making sure they're not available on the internet for more than a few "
"days."
msgstr ""
#: ../../source/advanced.rst:65
#: ../../source/advanced.rst:67
msgid "Command-line Interface"
msgstr ""
#: ../../source/advanced.rst:67
#: ../../source/advanced.rst:69
msgid ""
"In addition to its graphical interface, OnionShare has a command-line "
"interface."
msgstr ""
#: ../../source/advanced.rst:69
#: ../../source/advanced.rst:71
msgid ""
"You can install just the command-line version of OnionShare using "
"``pip3``::"
msgstr ""
#: ../../source/advanced.rst:73
#: ../../source/advanced.rst:75
msgid ""
"Note that you will also need the ``tor`` package installed. In macOS, "
"install it with: ``brew install tor``"
msgstr ""
#: ../../source/advanced.rst:75
#: ../../source/advanced.rst:77
msgid "Then run it like this::"
msgstr ""
#: ../../source/advanced.rst:79
#: ../../source/advanced.rst:81
msgid ""
"For information about installing it on different operating systems, see "
"the `CLI readme file "
"<https://github.com/onionshare/onionshare/blob/develop/cli/README.md>`_ "
"in the git repository."
msgstr ""
#: ../../source/advanced.rst:83
msgid ""
"If you installed OnionShare using the Linux Snapcraft package, you can "
"also just run ``onionshare.cli`` to access the command-line interface "
"version."
msgstr ""
#: ../../source/advanced.rst:82
#: ../../source/advanced.rst:86
msgid "Usage"
msgstr ""
#: ../../source/advanced.rst:84
#: ../../source/advanced.rst:88
msgid ""
"You can browse the command-line documentation by running ``onionshare "
"--help``::"
msgstr ""
#: ../../source/advanced.rst:147
msgid "Legacy Addresses"
msgstr ""
#: ../../source/advanced.rst:149
msgid ""
"OnionShare uses v3 Tor onion services by default. These are modern onion "
"addresses that have 56 characters, for example::"
msgstr ""
#: ../../source/advanced.rst:154
msgid ""
"OnionShare still has support for v2 onion addresses, the old type of "
"onion addresses that have 16 characters, for example::"
msgstr ""
#: ../../source/advanced.rst:158
msgid ""
"OnionShare calls v2 onion addresses \"legacy addresses\", and they are "
"not recommended, as v3 onion addresses are more secure."
msgstr ""
#: ../../source/advanced.rst:160
msgid ""
"To use legacy addresses, before starting a server click \"Show advanced "
"settings\" from its tab and check the \"Use a legacy address (v2 onion "
"service, not recommended)\" box. In legacy mode you can optionally turn "
"on Tor client authentication. Once you start a server in legacy mode you "
"cannot remove legacy mode in that tab. Instead you must start a separate "
"service in a separate tab."
msgstr ""
#: ../../source/advanced.rst:165
msgid ""
"Tor Project plans to `completely deprecate v2 onion services "
"<https://blog.torproject.org/v2-deprecation-timeline>`_ on October 15, "
"2021, and legacy onion services will be removed from OnionShare before "
"then."
msgstr ""
#~ msgid "Make a symbolic link to the OnionShare command line binary line this::"
#~ msgstr ""
@ -419,3 +390,121 @@ msgstr ""
#~ " OnionShare as well."
#~ msgstr ""
#~ msgid ""
#~ "When you quit OnionShare and then "
#~ "open it again, your saved tabs "
#~ "will start opened. You'll have to "
#~ "manually start each service, but when"
#~ " you do they will start with "
#~ "the same OnionShare address and "
#~ "password."
#~ msgstr ""
#~ msgid "Turn Off Passwords"
#~ msgstr ""
#~ msgid ""
#~ "By default, all OnionShare services are"
#~ " protected with the username ``onionshare``"
#~ " and a randomly-generated password. "
#~ "If someone takes 20 wrong guesses "
#~ "at the password, your onion service "
#~ "is automatically stopped to prevent a"
#~ " brute force attack against the "
#~ "OnionShare service."
#~ msgstr ""
#~ msgid ""
#~ "Sometimes you might want your OnionShare"
#~ " service to be accessible to the "
#~ "public, like if you want to set"
#~ " up an OnionShare receive service so"
#~ " the public can securely and "
#~ "anonymously send you files. In this "
#~ "case, it's better to disable the "
#~ "password altogether. If you don't do "
#~ "this, someone can force your server "
#~ "to stop just by making 20 wrong"
#~ " guesses of your password, even if"
#~ " they know the correct password."
#~ msgstr ""
#~ msgid ""
#~ "To turn off the password for any"
#~ " tab, just check the \"Don't use "
#~ "a password\" box before starting the "
#~ "server. Then the server will be "
#~ "public and won't have a password."
#~ msgstr ""
#~ msgid "Legacy Addresses"
#~ msgstr ""
#~ msgid ""
#~ "OnionShare uses v3 Tor onion services"
#~ " by default. These are modern onion"
#~ " addresses that have 56 characters, "
#~ "for example::"
#~ msgstr ""
#~ msgid ""
#~ "OnionShare still has support for v2 "
#~ "onion addresses, the old type of "
#~ "onion addresses that have 16 characters,"
#~ " for example::"
#~ msgstr ""
#~ msgid ""
#~ "OnionShare calls v2 onion addresses "
#~ "\"legacy addresses\", and they are not"
#~ " recommended, as v3 onion addresses "
#~ "are more secure."
#~ msgstr ""
#~ msgid ""
#~ "To use legacy addresses, before starting"
#~ " a server click \"Show advanced "
#~ "settings\" from its tab and check "
#~ "the \"Use a legacy address (v2 "
#~ "onion service, not recommended)\" box. "
#~ "In legacy mode you can optionally "
#~ "turn on Tor client authentication. Once"
#~ " you start a server in legacy "
#~ "mode you cannot remove legacy mode "
#~ "in that tab. Instead you must "
#~ "start a separate service in a "
#~ "separate tab."
#~ msgstr ""
#~ msgid ""
#~ "Tor Project plans to `completely "
#~ "deprecate v2 onion services "
#~ "<https://blog.torproject.org/v2-deprecation-timeline>`_ on"
#~ " October 15, 2021, and legacy onion"
#~ " services will be removed from "
#~ "OnionShare before then."
#~ msgstr ""
#~ msgid ""
#~ "By default, all OnionShare services are"
#~ " protected with a private key, which"
#~ " Tor calls Client Authentication."
#~ msgstr ""
#~ msgid ""
#~ "**Scheduling an OnionShare service to "
#~ "automatically stop can be useful to "
#~ "limit exposure**, like if you want "
#~ "to share secret documents while making"
#~ " sure they're not available on the"
#~ " Internet for more than a few "
#~ "days."
#~ msgstr ""
#~ msgid ""
#~ "For more information, see the `CLI "
#~ "readme file "
#~ "<https://github.com/onionshare/onionshare/blob/develop/cli/README.md>`_"
#~ " in the git repository."
#~ msgstr ""

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-08-20 13:37-0700\n"
"POT-Creation-Date: 2021-09-09 19:15-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"
@ -108,42 +108,42 @@ msgid ""
"reloaded), and other debug info. For example::"
msgstr ""
#: ../../source/develop.rst:121
#: ../../source/develop.rst:117
msgid ""
"You can add your own debug messages by running the ``Common.log`` method "
"from ``onionshare/common.py``. For example::"
msgstr ""
#: ../../source/develop.rst:125
#: ../../source/develop.rst:121
msgid ""
"This can be useful when learning the chain of events that occur when "
"using OnionShare, or the value of certain variables before and after they"
" are manipulated."
msgstr ""
#: ../../source/develop.rst:128
#: ../../source/develop.rst:124
msgid "Local Only"
msgstr ""
#: ../../source/develop.rst:130
#: ../../source/develop.rst:126
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:167
#: ../../source/develop.rst:165
msgid ""
"In this case, you load the URL ``http://onionshare:train-"
"system@127.0.0.1:17635`` in a normal web-browser like Firefox, instead of"
" using the Tor Browser."
"In this case, you load the URL ``http://127.0.0.1:17641`` in a normal "
"web-browser like Firefox, instead of using the Tor Browser. The private "
"key is not actually needed in local-only mode, so you can ignore it."
msgstr ""
#: ../../source/develop.rst:170
#: ../../source/develop.rst:168
msgid "Contributing Translations"
msgstr ""
#: ../../source/develop.rst:172
#: ../../source/develop.rst:170
msgid ""
"Help make OnionShare easier to use and more familiar and welcoming for "
"people by translating it on `Hosted Weblate "
@ -152,21 +152,21 @@ msgid ""
"needed."
msgstr ""
#: ../../source/develop.rst:174
#: ../../source/develop.rst:172
msgid "To help translate, make a Hosted Weblate account and start contributing."
msgstr ""
#: ../../source/develop.rst:177
#: ../../source/develop.rst:175
msgid "Suggestions for Original English Strings"
msgstr ""
#: ../../source/develop.rst:179
#: ../../source/develop.rst:177
msgid ""
"Sometimes the original English strings are wrong, or don't match between "
"the application and the documentation."
msgstr ""
#: ../../source/develop.rst:181
#: ../../source/develop.rst:179
msgid ""
"File source string improvements by adding @kingu to your Weblate comment,"
" or open a GitHub issue or pull request. The latter ensures all upstream "
@ -174,11 +174,11 @@ msgid ""
"the usual code review processes."
msgstr ""
#: ../../source/develop.rst:185
#: ../../source/develop.rst:183
msgid "Status of Translations"
msgstr ""
#: ../../source/develop.rst:186
#: ../../source/develop.rst:184
msgid ""
"Here is the current translation status. If you want start a translation "
"in a language not yet started, please write to the mailing list: "
@ -432,3 +432,19 @@ msgstr ""
#~ " for the graphical version."
#~ msgstr ""
#~ msgid ""
#~ "In this case, you load the URL "
#~ "``http://onionshare:train-system@127.0.0.1:17635`` in "
#~ "a normal web-browser like Firefox, "
#~ "instead of using the Tor Browser."
#~ msgstr ""
#~ msgid ""
#~ "In this case, you load the URL "
#~ "``http://127.0.0.1:17621`` in a normal web-"
#~ "browser like Firefox, instead of using"
#~ " the Tor Browser. The Private key "
#~ "is not actually needed in local-"
#~ "only mode, so you can ignore it."
#~ msgstr ""

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-05-03 21:48-0700\n"
"POT-Creation-Date: 2021-09-09 19:15-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"
@ -29,35 +29,43 @@ msgid ""
msgstr ""
#: ../../source/features.rst:8
msgid ""
"By default, OnionShare web addresses are protected with a random "
"password. A typical OnionShare address might look something like this::"
msgid "By default, OnionShare web addresses are protected with a private key."
msgstr ""
#: ../../source/features.rst:12
msgid ""
"You're responsible for securely sharing that URL using a communication "
"channel of your choice like in an encrypted chat message, or using "
"something less secure like unencrypted e-mail, depending on your `threat "
"model <https://ssd.eff.org/module/your-security-plan>`_."
#: ../../source/features.rst:10
msgid "OnionShare addresses look something like this::"
msgstr ""
#: ../../source/features.rst:14
msgid ""
"The people you send the URL to then copy and paste it into their `Tor "
"Browser <https://www.torproject.org/>`_ to access the OnionShare service."
msgstr ""
#: ../../source/features.rst:16
msgid ""
"If you run OnionShare on your laptop to send someone files, and then "
"suspend it before the files are sent, the service will not be available "
"until your laptop is unsuspended and on the Internet again. OnionShare "
"works best when working with people in real-time."
msgid "And private keys might look something like this::"
msgstr ""
#: ../../source/features.rst:18
msgid ""
"You're responsible for securely sharing that URL and private key using a "
"communication channel of your choice like in an encrypted chat message, "
"or using something less secure like unencrypted email, depending on your "
"`threat model <https://ssd.eff.org/module/your-security-plan>`_."
msgstr ""
#: ../../source/features.rst:20
msgid ""
"The people you send the URL to then copy and paste it into their `Tor "
"Browser <https://www.torproject.org/>`_ to access the OnionShare service."
" Tor Browser will then prompt for the private key, which the people can "
"also then copy and paste in."
msgstr ""
#: ../../source/features.rst:24
msgid ""
"If you run OnionShare on your laptop to send someone files, and then "
"suspend it before the files are sent, the service will not be available "
"until your laptop is unsuspended and on the internet again. OnionShare "
"works best when working with people in real-time."
msgstr ""
#: ../../source/features.rst:26
msgid ""
"Because your own computer is the web server, *no third party can access "
"anything that happens in OnionShare*, not even the developers of "
"OnionShare. It's completely private. And because OnionShare is based on "
@ -65,40 +73,40 @@ msgid ""
":doc:`security design </security>` for more info."
msgstr ""
#: ../../source/features.rst:21
#: ../../source/features.rst:29
msgid "Share Files"
msgstr ""
#: ../../source/features.rst:23
#: ../../source/features.rst:31
msgid ""
"You can use OnionShare to send files and folders to people securely and "
"anonymously. Open a share tab, drag in the files and folders you wish to "
"share, and click \"Start sharing\"."
msgstr ""
#: ../../source/features.rst:27 ../../source/features.rst:104
#: ../../source/features.rst:35 ../../source/features.rst:112
msgid ""
"After you add files, you'll see some settings. Make sure you choose the "
"setting you're interested in before you start sharing."
msgstr ""
#: ../../source/features.rst:31
#: ../../source/features.rst:39
msgid ""
"As soon as someone finishes downloading your files, OnionShare will "
"automatically stop the server, removing the website from the Internet. To"
"automatically stop the server, removing the website from the internet. To"
" allow multiple people to download them, uncheck the \"Stop sharing after"
" files have been sent (uncheck to allow downloading individual files)\" "
"box."
msgstr ""
#: ../../source/features.rst:34
#: ../../source/features.rst:42
msgid ""
"Also, if you uncheck this box, people will be able to download the "
"individual files you share rather than a single compressed version of all"
" the files."
msgstr ""
#: ../../source/features.rst:36
#: ../../source/features.rst:44
msgid ""
"When you're ready to share, click the \"Start sharing\" button. You can "
"always click \"Stop sharing\", or quit OnionShare, immediately taking the"
@ -106,27 +114,26 @@ msgid ""
"to show the history and progress of people downloading files from you."
msgstr ""
#: ../../source/features.rst:40
#: ../../source/features.rst:48
msgid ""
"Now that you have a OnionShare, copy the address and send it to the "
"person you want to receive the files. If the files need to stay secure, "
"or the person is otherwise exposed to danger, use an encrypted messaging "
"app."
"Now that you have a OnionShare, copy the address and the private key and "
"send it to the person you want to receive the files. If the files need to"
" stay secure, or the person is otherwise exposed to danger, use an "
"encrypted messaging app."
msgstr ""
#: ../../source/features.rst:42
#: ../../source/features.rst:50
msgid ""
"That person then must load the address in Tor Browser. After logging in "
"with the random password included in the web address, the files can be "
"downloaded directly from your computer by clicking the \"Download Files\""
" link in the corner."
"with the private key, the files can be downloaded directly from your "
"computer by clicking the \"Download Files\" link in the corner."
msgstr ""
#: ../../source/features.rst:47
#: ../../source/features.rst:55
msgid "Receive Files and Messages"
msgstr ""
#: ../../source/features.rst:49
#: ../../source/features.rst:57
msgid ""
"You can use OnionShare to let people anonymously submit files and "
"messages directly to your computer, essentially turning it into an "
@ -134,18 +141,18 @@ msgid ""
"want."
msgstr ""
#: ../../source/features.rst:54
#: ../../source/features.rst:62
msgid "You can browse for a folder to save messages and files that get submitted."
msgstr ""
#: ../../source/features.rst:56
#: ../../source/features.rst:64
msgid ""
"You can check \"Disable submitting text\" if want to only allow file "
"uploads, and you can check \"Disable uploading files\" if you want to "
"only allow submitting text messages, like for an anonymous contact form."
msgstr ""
#: ../../source/features.rst:58
#: ../../source/features.rst:66
msgid ""
"You can check \"Use notification webhook\" and then choose a webhook URL "
"if you want to be notified when someone submits files or messages to your"
@ -160,7 +167,7 @@ msgid ""
" letting you know as soon as it happens."
msgstr ""
#: ../../source/features.rst:63
#: ../../source/features.rst:71
msgid ""
"When you are ready, click \"Start Receive Mode\". This starts the "
"OnionShare service. Anyone loading this address in their Tor Browser will"
@ -168,17 +175,17 @@ msgid ""
"computer."
msgstr ""
#: ../../source/features.rst:67
#: ../../source/features.rst:75
msgid ""
"You can also click the down \"↓\" icon in the top-right corner to show "
"the history and progress of people sending files to you."
msgstr ""
#: ../../source/features.rst:69
#: ../../source/features.rst:77
msgid "Here is what it looks like for someone sending you files and messages."
msgstr ""
#: ../../source/features.rst:73
#: ../../source/features.rst:81
msgid ""
"When someone submits files or messages to your receive service, by "
"default they get saved to a folder called ``OnionShare`` in the home "
@ -186,7 +193,7 @@ msgid ""
" based on the time that the files get uploaded."
msgstr ""
#: ../../source/features.rst:75
#: ../../source/features.rst:83
msgid ""
"Setting up an OnionShare receiving service is useful for journalists and "
"others needing to securely accept documents from anonymous sources. When "
@ -195,19 +202,19 @@ msgid ""
"whistleblower submission system."
msgstr ""
#: ../../source/features.rst:78
#: ../../source/features.rst:86
msgid "Use at your own risk"
msgstr ""
#: ../../source/features.rst:80
#: ../../source/features.rst:88
msgid ""
"Just like with malicious e-mail attachments, it's possible someone could "
"Just like with malicious email attachments, it's possible someone could "
"try to attack your computer by uploading a malicious file to your "
"OnionShare service. OnionShare does not add any safety mechanisms to "
"protect your system from malicious files."
msgstr ""
#: ../../source/features.rst:82
#: ../../source/features.rst:90
msgid ""
"If you receive an Office document or a PDF through OnionShare, you can "
"convert these documents into PDFs that are safe to open using `Dangerzone"
@ -217,42 +224,42 @@ msgid ""
"disposableVM."
msgstr ""
#: ../../source/features.rst:84
#: ../../source/features.rst:92
msgid "However, it is always safe to open text messages sent through OnionShare."
msgstr ""
#: ../../source/features.rst:87
#: ../../source/features.rst:95
msgid "Tips for running a receive service"
msgstr ""
#: ../../source/features.rst:89
#: ../../source/features.rst:97
msgid ""
"If you want to host your own anonymous dropbox using OnionShare, it's "
"recommended you do so on a separate, dedicated computer always powered on"
" and connected to the Internet, and not on the one you use on a regular "
" and connected to the internet, and not on the one you use on a regular "
"basis."
msgstr ""
#: ../../source/features.rst:91
#: ../../source/features.rst:99
msgid ""
"If you intend to put the OnionShare address on your website or social "
"media profiles, save the tab (see :ref:`save_tabs`) and run it as a "
"public service (see :ref:`turn_off_passwords`). It's also a good idea to "
"give it a custom title (see :ref:`custom_titles`)."
"public service (see :ref:`turn_off_private_key`). It's also a good idea "
"to give it a custom title (see :ref:`custom_titles`)."
msgstr ""
#: ../../source/features.rst:94
#: ../../source/features.rst:102
msgid "Host a Website"
msgstr ""
#: ../../source/features.rst:96
#: ../../source/features.rst:104
msgid ""
"To host a static HTML website with OnionShare, open a website tab, drag "
"the files and folders that make up the static content there, and click "
"\"Start sharing\" when you are ready."
msgstr ""
#: ../../source/features.rst:100
#: ../../source/features.rst:108
msgid ""
"If you add an ``index.html`` file, it will render when someone loads your"
" website. You should also include any other HTML files, CSS files, "
@ -262,27 +269,27 @@ msgid ""
" WordPress.)"
msgstr ""
#: ../../source/features.rst:102
#: ../../source/features.rst:110
msgid ""
"If you don't have an ``index.html`` file, it will show a directory "
"listing instead, and people loading it can look through the files and "
"download them."
msgstr ""
#: ../../source/features.rst:109
#: ../../source/features.rst:117
msgid "Content Security Policy"
msgstr ""
#: ../../source/features.rst:111
#: ../../source/features.rst:119
msgid ""
"By default OnionShare helps secure your website by setting a strict "
"`Content Security Police "
"`Content Security Policy "
"<https://en.wikipedia.org/wiki/Content_Security_Policy>`_ header. "
"However, this prevents third-party content from loading inside the web "
"page."
msgstr ""
#: ../../source/features.rst:113
#: ../../source/features.rst:121
msgid ""
"If you want to load content from third-party websites, like assets or "
"JavaScript libraries from CDNs, check the \"Don't send Content Security "
@ -290,45 +297,45 @@ msgid ""
"before starting the service."
msgstr ""
#: ../../source/features.rst:116
#: ../../source/features.rst:124
msgid "Tips for running a website service"
msgstr ""
#: ../../source/features.rst:118
#: ../../source/features.rst:126
msgid ""
"If you want to host a long-term website using OnionShare (meaning not "
"something to quickly show someone something), it's recommended you do it "
"on a separate, dedicated computer always powered on and connected to the "
"Internet, and not on the one you use on a regular basis. Save the tab "
"(see :ref:`save_tabs`) so you can resume the website with the same "
"just to quickly show someone something), it's recommended you do it on a "
"separate, dedicated computer that is always powered on and connected to "
"the internet, and not on the one you use on a regular basis. Save the tab"
" (see :ref:`save_tabs`) so you can resume the website with the same "
"address if you close OnionShare and re-open it later."
msgstr ""
#: ../../source/features.rst:121
#: ../../source/features.rst:129
msgid ""
"If your website is intended for the public, you should run it as a public"
" service (see :ref:`turn_off_passwords`)."
" service (see :ref:`turn_off_private_key`)."
msgstr ""
#: ../../source/features.rst:124
#: ../../source/features.rst:132
msgid "Chat Anonymously"
msgstr ""
#: ../../source/features.rst:126
#: ../../source/features.rst:134
msgid ""
"You can use OnionShare to set up a private, secure chat room that doesn't"
" log anything. Just open a chat tab and click \"Start chat server\"."
msgstr ""
#: ../../source/features.rst:130
#: ../../source/features.rst:138
msgid ""
"After you start the server, copy the OnionShare address and send it to "
"the people you want in the anonymous chat room. If it's important to "
"limit exactly who can join, use an encrypted messaging app to send out "
"the OnionShare address."
"After you start the server, copy the OnionShare address and private key "
"and send them to the people you want in the anonymous chat room. If it's "
"important to limit exactly who can join, use an encrypted messaging app "
"to send out the OnionShare address and private key."
msgstr ""
#: ../../source/features.rst:135
#: ../../source/features.rst:143
msgid ""
"People can join the chat room by loading its OnionShare address in Tor "
"Browser. The chat room requires JavasScript, so everyone who wants to "
@ -336,7 +343,7 @@ msgid ""
"\"Standard\" or \"Safer\", instead of \"Safest\"."
msgstr ""
#: ../../source/features.rst:138
#: ../../source/features.rst:146
msgid ""
"When someone joins the chat room they get assigned a random name. They "
"can change their name by typing a new name in the box in the left panel "
@ -344,13 +351,13 @@ msgid ""
"get displayed at all, even if others were already chatting in the room."
msgstr ""
#: ../../source/features.rst:144
#: ../../source/features.rst:152
msgid ""
"In an OnionShare chat room, everyone is anonymous. Anyone can change "
"their name to anything, and there is no way to confirm anyone's identity."
msgstr ""
#: ../../source/features.rst:147
#: ../../source/features.rst:155
msgid ""
"However, if you create an OnionShare chat room and securely send the "
"address only to a small group of trusted friends using encrypted "
@ -358,21 +365,21 @@ msgid ""
"room are your friends."
msgstr ""
#: ../../source/features.rst:150
#: ../../source/features.rst:158
msgid "How is this useful?"
msgstr ""
#: ../../source/features.rst:152
#: ../../source/features.rst:160
msgid ""
"If you need to already be using an encrypted messaging app, what's the "
"point of an OnionShare chat room to begin with? It leaves less traces."
msgstr ""
#: ../../source/features.rst:154
#: ../../source/features.rst:162
msgid ""
"If you for example send a message to a Signal group, a copy of your "
"message ends up on each device (the devices, and computers if they set up"
" Signal Desktop) of each member of the group. Even if disappearing "
"message ends up on each device (the smartphones, and computers if they "
"set up Signal Desktop) of each member of the group. Even if disappearing "
"messages is turned on, it's hard to confirm all copies of the messages "
"are actually deleted from all devices, and from any other places (like "
"notifications databases) they may have been saved to. OnionShare chat "
@ -380,21 +387,21 @@ msgid ""
"minimum."
msgstr ""
#: ../../source/features.rst:157
#: ../../source/features.rst:165
msgid ""
"OnionShare chat rooms can also be useful for people wanting to chat "
"anonymously and securely with someone without needing to create any "
"accounts. For example, a source can send an OnionShare address to a "
"journalist using a disposable e-mail address, and then wait for the "
"journalist using a disposable email address, and then wait for the "
"journalist to join the chat room, all without compromosing their "
"anonymity."
msgstr ""
#: ../../source/features.rst:161
#: ../../source/features.rst:169
msgid "How does the encryption work?"
msgstr ""
#: ../../source/features.rst:163
#: ../../source/features.rst:171
msgid ""
"Because OnionShare relies on Tor onion services, connections between the "
"Tor Browser and OnionShare are all end-to-end encrypted (E2EE). When "
@ -404,7 +411,7 @@ msgid ""
" connections."
msgstr ""
#: ../../source/features.rst:165
#: ../../source/features.rst:173
msgid ""
"OnionShare doesn't implement any chat encryption on its own. It relies on"
" the Tor onion service's encryption instead."
@ -841,3 +848,201 @@ msgstr ""
#~ ":ref:`turn_off_passwords`)."
#~ msgstr ""
#~ msgid ""
#~ "By default, OnionShare web addresses are"
#~ " protected with a random password. A"
#~ " typical OnionShare address might look "
#~ "something like this::"
#~ msgstr ""
#~ msgid ""
#~ "You're responsible for securely sharing "
#~ "that URL using a communication channel"
#~ " of your choice like in an "
#~ "encrypted chat message, or using "
#~ "something less secure like unencrypted "
#~ "e-mail, depending on your `threat model"
#~ " <https://ssd.eff.org/module/your-security-plan>`_."
#~ msgstr ""
#~ msgid ""
#~ "That person then must load the "
#~ "address in Tor Browser. After logging"
#~ " in with the random password included"
#~ " in the web address, the files "
#~ "can be downloaded directly from your "
#~ "computer by clicking the \"Download "
#~ "Files\" link in the corner."
#~ msgstr ""
#~ msgid ""
#~ "If you intend to put the "
#~ "OnionShare address on your website or"
#~ " social media profiles, save the tab"
#~ " (see :ref:`save_tabs`) and run it as"
#~ " a public service (see "
#~ ":ref:`turn_off_passwords`). It's also a good"
#~ " idea to give it a custom title"
#~ " (see :ref:`custom_titles`)."
#~ msgstr ""
#~ msgid ""
#~ "If your website is intended for "
#~ "the public, you should run it as"
#~ " a public service (see "
#~ ":ref:`turn_off_passwords`)."
#~ msgstr ""
#~ msgid ""
#~ "By default, OnionShare web addresses are"
#~ " protected with a private key (Client"
#~ " Authentication). A typical OnionShare "
#~ "address might look something like this::"
#~ msgstr ""
#~ msgid "And the Private key might look something like this::"
#~ msgstr ""
#~ msgid ""
#~ "You're responsible for securely sharing "
#~ "that URL, and the private key, "
#~ "using a communication channel of your"
#~ " choice like in an encrypted chat "
#~ "message, or using something less secure"
#~ " like unencrypted e-mail, depending on "
#~ "your `threat model <https://ssd.eff.org/module"
#~ "/your-security-plan>`_."
#~ msgstr ""
#~ msgid ""
#~ "The people you send the URL to "
#~ "then copy and paste it into their"
#~ " `Tor Browser <https://www.torproject.org/>`_ to"
#~ " access the OnionShare service."
#~ msgstr ""
#~ msgid ""
#~ "Tor Browser will then prompt for "
#~ "the private key in an authentication "
#~ "dialog, which the person can also "
#~ "then copy and paste in."
#~ msgstr ""
#~ msgid ""
#~ "If you run OnionShare on your "
#~ "laptop to send someone files, and "
#~ "then suspend it before the files "
#~ "are sent, the service will not be"
#~ " available until your laptop is "
#~ "unsuspended and on the Internet again."
#~ " OnionShare works best when working "
#~ "with people in real-time."
#~ msgstr ""
#~ msgid ""
#~ "As soon as someone finishes downloading"
#~ " your files, OnionShare will automatically"
#~ " stop the server, removing the "
#~ "website from the Internet. To allow "
#~ "multiple people to download them, "
#~ "uncheck the \"Stop sharing after files"
#~ " have been sent (uncheck to allow "
#~ "downloading individual files)\" box."
#~ msgstr ""
#~ msgid ""
#~ "Now that you have a OnionShare, "
#~ "copy the address and send it to"
#~ " the person you want to receive "
#~ "the files. If the files need to"
#~ " stay secure, or the person is "
#~ "otherwise exposed to danger, use an "
#~ "encrypted messaging app."
#~ msgstr ""
#~ msgid ""
#~ "Just like with malicious e-mail "
#~ "attachments, it's possible someone could "
#~ "try to attack your computer by "
#~ "uploading a malicious file to your "
#~ "OnionShare service. OnionShare does not "
#~ "add any safety mechanisms to protect "
#~ "your system from malicious files."
#~ msgstr ""
#~ msgid ""
#~ "If you want to host your own "
#~ "anonymous dropbox using OnionShare, it's "
#~ "recommended you do so on a "
#~ "separate, dedicated computer always powered"
#~ " on and connected to the Internet,"
#~ " and not on the one you use "
#~ "on a regular basis."
#~ msgstr ""
#~ msgid ""
#~ "By default OnionShare helps secure your"
#~ " website by setting a strict `Content"
#~ " Security Police "
#~ "<https://en.wikipedia.org/wiki/Content_Security_Policy>`_ "
#~ "header. However, this prevents third-"
#~ "party content from loading inside the"
#~ " web page."
#~ msgstr ""
#~ msgid ""
#~ "If you want to host a long-"
#~ "term website using OnionShare (meaning "
#~ "not something to quickly show someone"
#~ " something), it's recommended you do "
#~ "it on a separate, dedicated computer "
#~ "always powered on and connected to "
#~ "the Internet, and not on the one"
#~ " you use on a regular basis. "
#~ "Save the tab (see :ref:`save_tabs`) so"
#~ " you can resume the website with "
#~ "the same address if you close "
#~ "OnionShare and re-open it later."
#~ msgstr ""
#~ msgid ""
#~ "After you start the server, copy "
#~ "the OnionShare address and send it "
#~ "to the people you want in the "
#~ "anonymous chat room. If it's important"
#~ " to limit exactly who can join, "
#~ "use an encrypted messaging app to "
#~ "send out the OnionShare address."
#~ msgstr ""
#~ msgid ""
#~ "If you for example send a message"
#~ " to a Signal group, a copy of"
#~ " your message ends up on each "
#~ "device (the devices, and computers if"
#~ " they set up Signal Desktop) of "
#~ "each member of the group. Even if"
#~ " disappearing messages is turned on, "
#~ "it's hard to confirm all copies of"
#~ " the messages are actually deleted "
#~ "from all devices, and from any "
#~ "other places (like notifications databases)"
#~ " they may have been saved to. "
#~ "OnionShare chat rooms don't store any"
#~ " messages anywhere, so the problem is"
#~ " reduced to a minimum."
#~ msgstr ""
#~ msgid ""
#~ "OnionShare chat rooms can also be "
#~ "useful for people wanting to chat "
#~ "anonymously and securely with someone "
#~ "without needing to create any accounts."
#~ " For example, a source can send "
#~ "an OnionShare address to a journalist"
#~ " using a disposable e-mail address, "
#~ "and then wait for the journalist "
#~ "to join the chat room, all without"
#~ " compromosing their anonymity."
#~ msgstr ""

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-12-13 15:48-0800\n"
"POT-Creation-Date: 2021-09-09 19:15-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"
@ -32,7 +32,7 @@ msgid ""
msgstr ""
#: ../../source/install.rst:12
msgid "Install in Linux"
msgid "Linux"
msgstr ""
#: ../../source/install.rst:14
@ -67,11 +67,22 @@ msgid ""
msgstr ""
#: ../../source/install.rst:28
msgid "Verifying PGP signatures"
msgid "Command-line only"
msgstr ""
#: ../../source/install.rst:30
msgid ""
"You can install just the command line version of OnionShare on any "
"operating system using the Python package manager ``pip``. See :ref:`cli`"
" for more information."
msgstr ""
#: ../../source/install.rst:35
msgid "Verifying PGP signatures"
msgstr ""
#: ../../source/install.rst:37
msgid ""
"You can verify that the package you download is legitimate and hasn't "
"been tampered with by verifying its PGP signature. For Windows and macOS,"
" this step is optional and provides defense in depth: the OnionShare "
@ -79,11 +90,11 @@ msgid ""
"rely on those alone if you'd like."
msgstr ""
#: ../../source/install.rst:34
#: ../../source/install.rst:41
msgid "Signing key"
msgstr ""
#: ../../source/install.rst:36
#: ../../source/install.rst:43
msgid ""
"Packages are signed by Micah Lee, the core developer, using his PGP "
"public key with fingerprint ``927F419D7EC82C2F149C1BD1403C2657CD994F73``."
@ -92,18 +103,18 @@ msgid ""
"fingerprint/927F419D7EC82C2F149C1BD1403C2657CD994F73>`_."
msgstr ""
#: ../../source/install.rst:38
#: ../../source/install.rst:45
msgid ""
"You must have GnuPG installed to verify signatures. For macOS you "
"probably want `GPGTools <https://gpgtools.org/>`_, and for Windows you "
"probably want `Gpg4win <https://www.gpg4win.org/>`_."
msgstr ""
#: ../../source/install.rst:41
#: ../../source/install.rst:48
msgid "Signatures"
msgstr ""
#: ../../source/install.rst:43
#: ../../source/install.rst:50
msgid ""
"You can find the signatures (as ``.asc`` files), as well as Windows, "
"macOS, Flatpak, Snap, and source packages, at "
@ -112,35 +123,35 @@ msgid ""
"<https://github.com/micahflee/onionshare/releases>`_."
msgstr ""
#: ../../source/install.rst:47
#: ../../source/install.rst:54
msgid "Verifying"
msgstr ""
#: ../../source/install.rst:49
#: ../../source/install.rst:56
msgid ""
"Once you have imported Micah's public key into your GnuPG keychain, "
"downloaded the binary and and ``.asc`` signature, you can verify the "
"binary for macOS in a terminal like this::"
msgstr ""
#: ../../source/install.rst:53
#: ../../source/install.rst:60
msgid "Or for Windows, in a command-prompt like this::"
msgstr ""
#: ../../source/install.rst:57
#: ../../source/install.rst:64
msgid "The expected output looks like this::"
msgstr ""
#: ../../source/install.rst:69
#: ../../source/install.rst:76
msgid ""
"If you don't see 'Good signature from', there might be a problem with the"
" integrity of the file (malicious or otherwise), and you should not "
"install the package. (The \"WARNING:\" shown above, is not a problem with"
" the package, it only means you haven't already defined any level of "
"'trust' of Micah's PGP key.)"
"If you don't see ``Good signature from``, there might be a problem with "
"the integrity of the file (malicious or otherwise), and you should not "
"install the package. (The ``WARNING:`` shown above, is not a problem with"
" the package, it only means you haven't defined a level of \"trust\" of "
"Micah's PGP key.)"
msgstr ""
#: ../../source/install.rst:71
#: ../../source/install.rst:78
msgid ""
"If you want to learn more about verifying PGP signatures, the guides for "
"`Qubes OS <https://www.qubes-os.org/security/verifying-signatures/>`_ and"
@ -334,3 +345,22 @@ msgstr ""
#~ "verify-signature/>`_ may be helpful."
#~ msgstr ""
#~ msgid "Install in Linux"
#~ msgstr ""
#~ msgid ""
#~ "If you don't see 'Good signature "
#~ "from', there might be a problem "
#~ "with the integrity of the file "
#~ "(malicious or otherwise), and you should"
#~ " not install the package. (The "
#~ "\"WARNING:\" shown above, is not a "
#~ "problem with the package, it only "
#~ "means you haven't already defined any"
#~ " level of 'trust' of Micah's PGP "
#~ "key.)"
#~ msgstr ""
#~ msgid "Command Line Only"
#~ msgstr ""

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-12-13 15:48-0800\n"
"POT-Creation-Date: 2021-09-09 19:15-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"
@ -67,14 +67,11 @@ msgstr ""
msgid ""
"**If an attacker learns about the onion service, it still can't access "
"anything.** Prior attacks against the Tor network to enumerate onion "
"services allowed the attacker to discover private .onion addresses. If an"
" attack discovers a private OnionShare address, a password will be "
"prevent them from accessing it (unless the OnionShare user chooses to "
"turn it off and make it public). The password is generated by choosing "
"two random words from a list of 6800 words, making 6800², or about 46 "
"million possible passwords. Only 20 wrong guesses can be made before "
"OnionShare stops the server, preventing brute force attacks against the "
"password."
"services allowed the attacker to discover private ``.onion`` addresses. "
"If an attack discovers a private OnionShare address, they will also need "
"to guess the private key used for client authentication in order to "
"access it (unless the OnionShare user chooses make their serivce public "
"by turning off the private key -- see :ref:`turn_off_private_key`)."
msgstr ""
#: ../../source/security.rst:20
@ -83,24 +80,25 @@ msgstr ""
#: ../../source/security.rst:22
msgid ""
"**Communicating the OnionShare address might not be secure.** "
"Communicating the OnionShare address to people is the responsibility of "
"the OnionShare user. If sent insecurely (such as through an email message"
" monitored by an attacker), an eavesdropper can tell that OnionShare is "
"being used. If the eavesdropper loads the address in Tor Browser while "
"the service is still up, they can access it. To avoid this, the address "
"must be communicateed securely, via encrypted text message (probably with"
" disappearing messages enabled), encrypted email, or in person. This "
"isn't necessary when using OnionShare for something that isn't secret."
"**Communicating the OnionShare address and private key might not be "
"secure.** Communicating the OnionShare address to people is the "
"responsibility of the OnionShare user. If sent insecurely (such as "
"through an email message monitored by an attacker), an eavesdropper can "
"tell that OnionShare is being used. If the eavesdropper loads the address"
" in Tor Browser while the service is still up, they can access it. To "
"avoid this, the address must be communicateed securely, via encrypted "
"text message (probably with disappearing messages enabled), encrypted "
"email, or in person. This isn't necessary when using OnionShare for "
"something that isn't secret."
msgstr ""
#: ../../source/security.rst:24
msgid ""
"**Communicating the OnionShare address might not be anonymous.** Extra "
"precautions must be taken to ensure the OnionShare address is "
"communicated anonymously. A new email or chat account, only accessed over"
" Tor, can be used to share the address. This isn't necessary unless "
"anonymity is a goal."
"**Communicating the OnionShare address and private key might not be "
"anonymous.** Extra precautions must be taken to ensure the OnionShare "
"address is communicated anonymously. A new email or chat account, only "
"accessed over Tor, can be used to share the address. This isn't necessary"
" unless anonymity is a goal."
msgstr ""
#~ msgid "Security design"
@ -242,3 +240,73 @@ msgstr ""
#~ "necessary unless anonymity is a goal."
#~ msgstr ""
#~ msgid ""
#~ "**If an attacker learns about the "
#~ "onion service, it still can't access "
#~ "anything.** Prior attacks against the "
#~ "Tor network to enumerate onion services"
#~ " allowed the attacker to discover "
#~ "private .onion addresses. If an attack"
#~ " discovers a private OnionShare address,"
#~ " a password will be prevent them "
#~ "from accessing it (unless the OnionShare"
#~ " user chooses to turn it off "
#~ "and make it public). The password "
#~ "is generated by choosing two random "
#~ "words from a list of 6800 words,"
#~ " making 6800², or about 46 million"
#~ " possible passwords. Only 20 wrong "
#~ "guesses can be made before OnionShare"
#~ " stops the server, preventing brute "
#~ "force attacks against the password."
#~ msgstr ""
#~ msgid ""
#~ "**Communicating the OnionShare address might"
#~ " not be secure.** Communicating the "
#~ "OnionShare address to people is the "
#~ "responsibility of the OnionShare user. "
#~ "If sent insecurely (such as through "
#~ "an email message monitored by an "
#~ "attacker), an eavesdropper can tell that"
#~ " OnionShare is being used. If the "
#~ "eavesdropper loads the address in Tor"
#~ " Browser while the service is still"
#~ " up, they can access it. To "
#~ "avoid this, the address must be "
#~ "communicateed securely, via encrypted text "
#~ "message (probably with disappearing messages"
#~ " enabled), encrypted email, or in "
#~ "person. This isn't necessary when using"
#~ " OnionShare for something that isn't "
#~ "secret."
#~ msgstr ""
#~ msgid ""
#~ "**Communicating the OnionShare address might"
#~ " not be anonymous.** Extra precautions "
#~ "must be taken to ensure the "
#~ "OnionShare address is communicated "
#~ "anonymously. A new email or chat "
#~ "account, only accessed over Tor, can "
#~ "be used to share the address. This"
#~ " isn't necessary unless anonymity is "
#~ "a goal."
#~ msgstr ""
#~ msgid ""
#~ "**If an attacker learns about the "
#~ "onion service, it still can't access "
#~ "anything.** Prior attacks against the "
#~ "Tor network to enumerate onion services"
#~ " allowed the attacker to discover "
#~ "private .onion addresses. If an attack"
#~ " discovers a private OnionShare address,"
#~ " but not the private key used "
#~ "for Client Authentication, they will be"
#~ " prevented from accessing it (unless "
#~ "the OnionShare user chooses to turn "
#~ "off the private key and make it"
#~ " public - see :ref:`turn_off_private_key`)."
#~ msgstr ""

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: OnionShare 2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-12-13 15:48-0800\n"
"POT-Creation-Date: 2021-09-09 19:15-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"
@ -193,7 +193,7 @@ msgstr ""
#: ../../source/tor.rst:109
msgid ""
"If your access to the Internet is censored, you can configure OnionShare "
"If your access to the internet is censored, you can configure OnionShare "
"to connect to the Tor network using `Tor bridges "
"<https://2019.www.torproject.org/docs/bridges.html.en>`_. If OnionShare "
"connects to Tor without one, you don't need to use a bridge."
@ -444,3 +444,14 @@ msgstr ""
#~ "Then, install Tor::"
#~ msgstr ""
#~ msgid ""
#~ "If your access to the Internet is"
#~ " censored, you can configure OnionShare "
#~ "to connect to the Tor network "
#~ "using `Tor bridges "
#~ "<https://2019.www.torproject.org/docs/bridges.html.en>`_. If "
#~ "OnionShare connects to Tor without one,"
#~ " you don't need to use a "
#~ "bridge."
#~ msgstr ""