OnionSharen kehittäminen¶
Osallistuminen¶
OnionSharella on avoin Keybase-tiimi keskustelua, kysymyksiä, ideoita, ulkoasusuunnittelua ja projektin tulevaisuuden suunnitelua varten. (Se on myös helppo väylä lähettää päästä päähän salattuja suoria viestejä, kuten OnionShare-osoitteita.) Käyttääksesi Keybasea, tallenna Keybase-sovellus, luo käyttäjätili ja liity tähän tiimiin. Sovelluksen sisällä valitse ”Tiimit”, klikkaa ”Liity tiimiin” ja kirjoita ”onionshare”.
OnionSharella on myös keskustelua varten postituslista kehittäjille ja suunnittelijoille.
Avustaminen koodissa¶
OnionShare source code is to be found in this Git repository: https://github.com/onionshare/onionshare
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 on GitHub to see if there are any you’d like to tackle.
Kun olet valmis avustamaan koodissa, avaa vetopyyntö Githubissa ja joku projektin ylläpitäjistä arvioi sen ja mahdollisesti kysyy kysymyksiä, pyytää muutoksia, kieltäytyy siitä tai yhdistää sen toiseen projektiin.
Kehityksen aloittaminen¶
OnionShare is developed in Python.
To get started, clone the Git repository at https://github.com/onionshare/onionshare/ and then consult the cli/README.md file to learn how to set up your development environment for the command-line version, and the desktop/README.md file to learn how to set up your development environment for the graphical version.
Kyseiset tiedostot sisältävät välttämättömiä teknisia ohjeistuksia ja komentoja asentaaksesi riippuvuudet alustalle, ja jotta OnionShare voidaan suorittaa.
Virheenkorjauksen vinkkejä¶
Runsassanainen tila¶
Kehittämisen aikana on hyödyllistä suorittaa OnionShare terminaalista ja lisätä --verbose (tai -v) -lisäys komentoriville. Tämä tuo näkyviin paljon hyödyllisiä viestejä terminaaliin, kuten jos tietyt objektit on alustettu, kun ilmiöt tapahtuvat (esim. nappeja painetaan, asetukset tallennetaan tai ladataan), ja muuta virheenkorjaustietoa. Esimerkiksi:
$ $ poetry run onionshare-cli -v ~/Documents/roms/nes/Q-bert\ \(USA\).nes
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
[Sep 09 2021 19:13:20] Settings.__init__
[Sep 09 2021 19:13:20] Settings.load
[Sep 09 2021 19:13:20] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=wordlist.txt
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=wordlist.txt, path=/home/user/code/onionshare/cli/onionshare_cli/resources/wordlist.txt
[Sep 09 2021 19:13:20] ModeSettings.load: creating /home/user/.config/onionshare/persistent/polish-pushpin-hydrated.json
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.title = None
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.public = False
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.autostart_timer = 0
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.autostop_timer = 0
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: share.autostop_sharing = True
[Sep 09 2021 19:13:20] Web.__init__: is_gui=False, mode=share
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=static
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=static, path=/home/user/code/onionshare/cli/onionshare_cli/resources/static
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=templates
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=templates, path=/home/user/code/onionshare/cli/onionshare_cli/resources/templates
[Sep 09 2021 19:13:20] Web.generate_static_url_path: new static_url_path is /static_gvvq2hplxhs2cekk665kagei6m
[Sep 09 2021 19:13:20] ShareModeWeb.init
[Sep 09 2021 19:13:20] Onion.__init__
[Sep 09 2021 19:13:20] Onion.connect
[Sep 09 2021 19:13:20] Settings.__init__
[Sep 09 2021 19:13:20] Settings.load
[Sep 09 2021 19:13:20] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:20] Onion.connect: tor_data_directory_name=/home/user/.config/onionshare/tmp/tmpf3akiouy
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=torrc_template
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=torrc_template, path=/home/user/code/onionshare/cli/onionshare_cli/resources/torrc_template
Connecting to the Tor network: 100% - Done
[Sep 09 2021 19:13:30] Onion.connect: Connected to tor 0.4.6.7
[Sep 09 2021 19:13:30] Settings.load
[Sep 09 2021 19:13:30] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:30] OnionShare.__init__
[Sep 09 2021 19:13:30] OnionShare.start_onion_service
[Sep 09 2021 19:13:30] Onion.start_onion_service: port=17616
[Sep 09 2021 19:13:30] Onion.start_onion_service: key_type=NEW, key_content=ED25519-V3
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: general.service_id = vucwsdmjt7szoc6pel3puqoxobiepdsowmqaq7pm7dzhembtzr2capad
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.private_key = +HfFALM4MtrNh59ibfMtRwDCIpfpWHIcNh3boahqrHh3TkLAyQvzKTm/y53KoYKSh0VU+m9DZY7DtZuCzkHkqQ==
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.client_auth_priv_key = G24TSNLIJX7YZM6R7P24AIGRU4N56ZFL7ENZVIDIWUEWY66YS3EQ
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.client_auth_pub_key = GDY2EPXSS7Q3ELQJFIX2VELTVZ3QEYIGWIZ26CEDQKZJ5Y7VKI3A
Compressing files.
[Sep 09 2021 19:13:35] ShareModeWeb.init
[Sep 09 2021 19:13:35] ShareModeWeb.set_file_info_custom
[Sep 09 2021 19:13:35] ShareModeWeb.build_zipfile_list
[Sep 09 2021 19:13:35] Web.start: port=17616
* Running on http://127.0.0.1:17616/ (Press CTRL+C to quit)
Give this address and private key to the recipient:
http://vucwsdmjt7szoc6pel3puqoxobiepdsowmqaq7pm7dzhembtzr2capad.onion
Private key: G24TSNLIJX7YZM6R7P24AIGRU4N56ZFL7ENZVIDIWUEWY66YS3EQ
Press Ctrl+C to stop the server
Voit lisätä omia virheenkorjausviestejä suorittamalla Common.log``metodin kohteesta ``onionshare/common.py. Esimerkiksi:
common.log('OnionShareGui', 'start_server', 'I ran here')
Tämä voi olla hyödyllistä, kun opettelee tapahtumien kulkua OnionSharessa, tai tiettyjen muuttujien arvoja ennen ja jälkeen, kun niitä on muokattu.
Vain paikallinen¶
Tor on hidas ja on siksi hyödyllistä ohittaa sipulipalveluiden käynnistys kokonaan kehitystyön aikana. Voit tehdä tämän --local-only lisäyksellä. Esimerkiksi:
$ poetry run onionshare-cli --local-only --receive
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
* Running on http://127.0.0.1:17641/ (Press CTRL+C to quit)
Files sent to you appear in this folder: /home/user/OnionShare
Warning: Receive mode lets people upload files to your computer. Some files can potentially take control of your computer if you open them. Only open things from people you trust, or if you know what you are doing.
Give this address and private key to the sender:
http://127.0.0.1:17641
Private key: E2GOT5LTUTP3OAMRCRXO4GSH6VKJEUOXZQUC336SRKAHTTT5OVSA
Press Ctrl+C to stop the server
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.
Kielenkääntämisessä avustaminen¶
Auta tekemään OnionSharesta helppokäyttöisempää ja tutumpaa ihmisille kääntämällä sitä sivustolla Hosted Weblate. Pidä ”OnionShare” aina latinalaisissa aakkosissa ja käytä muotoa ”OnionShare (paikallinennimi)” tarvittaessa.
Auttaaksesi kääntämisessä tee käyttäjätunnus Hosted Weblate -sivustolle ja aloita auttaminen.
Ehdotuksia alkuperäisiksi englanninkielisiksi merkkijonoiksi¶
Joskus alkuperäiset englanninkieliset merkkijonot ovat väärin tai eivät vastaa sovellusta ja dokumentaatiota.
Ilmoita lähdemerkkijonojen parannukset lisäämällä @kingu sinun tekemääsi Weblate-kommenttiin, tai avaamalla GitHubiin ilmoitus tai vetopyyntö. Jälkimmäinen takaa, että kaikki kehittäjät näkevät ehdotuksen ja he voivat mahdollisesti muokata merkkijonoa perinteisen koodinarviointiprosessin kautta.
Käännösten tila¶
Täällä näkyy nykyinen käännösten tila. Jos haluat aloittaa käännöksen kielellä, jota ei vielä ole aloitettu, kirjoita siitä postituslistalle: onionshare-dev@lists.riseup.net
