Zhvillim i OnionShare-it
Bashkëpunim
OnionShare ka një ekip të hapët në Keybase për të diskutuar rreth projektit, për të bërë pyetje, për të ndarë ide dhe konceptime dhe për të bërë plane për zhvillim të ardhshëm. (Është gjithashtu një rrugë e kollajtë për t’u dërguar të tjerëve mesazhe të drejtpërdrejta të fshehtëzuara, në bashkësinë OnionShare, bie fjala, adresa OnionShare.) Që të përdorni Keybase-in, shkarkoni aplikacionin Keybase, krijoni një llogari dhe bëhuni pjesë e këtij ekipi. Brenda aplikacionit, kaloni te “Ekipe”, klikoni “Bëhuni pjesë e një Ekipi” dhe shtypni “onionshare”.
OnionShare ka gjithashtu një listë postimesh për zhvillues dhe hartues grafikë për të diskutuar rreth projektit.
Kontribut Me Kod
Kodi burim i OnionShare-it mund të gjendet në këtë depo Git: https://github.com/onionshare/onionshare
Nëse do të donit të kontribuoni kod te OnionShare, ia vlen të bëheni pjesë e ekipit në Keybase dhe të bëni pyetje rreth çka po mendonit të merreni. Duhet të shqyrtoni gjithashtu krejt çështjet e hapura në GitHub, për të parë se mos ka ndonjë me të cilën do të donit të merreshit.
Kur të jeni gati të kontribuoni kod, hapni një kërkesë përzierjeje në depon GitHub dhe një nga mirëmbajtësit e projektit do ta shqyrtojë dhe me gjasa do të bëjë pyetje, do të kërkojë ndryshime, do ta hedhë poshtë, ose përziejë te projekti.
Si të Fillohet Zhvillimi
OnionShare zhvillohet në Python. Që t’ia filloni, klononi depon Git te https://github.com/onionshare/onionshare/ dhe mandej lexoni kartelën cli/README.md, që të mësoni si të ujdisni mjedisin tuaj të zhvillimit për versionin “rresht urdhrash”, si dhe kartelën desktop/README.md, që të mësoni se si të ujdisni mjedisin e zhvillimit për versionin grafik.
Këto kartela përmbajnë udhëzime të nevojshme teknike dhe urdhra për të instaluar varësi për platformën tuaj, si dhe për të xhiruar OnionShare-in që nga pema burim.
Ndihëmza diagnostikim
Mënyra fjalamane
Kur kryhet zhvillim, është me leverdi të xhirohet OnionShare-i që nga një terminal dhe të shtohet parametri --verbose (ose -v) te urdhri i xhirimit. Kjo bën që të shtypen te terminali plot mesazhe të dobishëm, bie fjala, kur gatiten disa objekte të caktuar, kur ndodhin akte (fjala vjen, klikohen butona, ruhen dhe ringarkohen rregullime) dhe të tjera informacione diagnostikimi. Për shembull:
$ poetry run onionshare-cli -v ~/Documents/roms/nes/Q-bert\ \(USA\).nes
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4.1 │
│ │
│ 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
Mund të shtoni mesazhet tuaj vetjakë të diagnostikimit duke xhiruar metodën Common.log që nga onionshare/common.py. Për shembull:
common.log('OnionShareGui', 'start_server', 'I ran here')
Kjo mund të jetë e dobishme kur mësohet vargu i akteve që ndodhin kur përdoret OnionShare, ose vlera e disa ndryshoreve para dhe pasi të jenë manipuluar.
Vetëm Vendore
Tor-i është i ngadaltë dhe shpesh ia vlen të anashkalohet fare nisja e shërbimeve Onion gjatë zhvillimi. Këtë mund ta bëni me parametrin --local-only. Për shembull:
$ poetry run onionshare-cli --local-only --receive
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4.1 │
│ │
│ 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
Në këtë rast, ju ngarkoni URL-në http://127.0.0.1:17641 në një shfletues të zakonshëm, në vend se të përdorni Shfletuesin Tor. Kyçi privat faktikisht nuk është i nevojshëm nën mënyrën vetëm-vendore, ndaj mund ta shpërfillni.
Kontribut Përkthimesh
Ndihmoni të bëhet OnionShare më i kollajtë për t’u përdorur dhe më familjar dhe mikpritës për njerëzit, duke e përkthyer në Hosted Weblate. “OnionShare”-in mbajeni përherë në shkronja latine dhe përdorni “OnionShare” (emri_si_keni_qejf)”, në u dashtë.
Për të ndihmuar me përkthim, krijoni një llogari në Hosted Weblate dhe filloni të kontribuoni.
Sugjerime për Vargjet Origjinale Në Anglisht
Disa nga vargjet origjinalë anglisht janë gabim, ose nuk përputhen me aplikacionit dhe dokumentimit.
Hapni çështje përmirësimi vargjesh burim, duke shtuar @kingu te komenti juaj në Weblate, ose hapni një çështje, ose kërkesë për tërheqje kodi, në GitHub. Kjo e fundit bën të mundur që sugjerimin ta shohin krejt zhvilluesit dhe mundet, potencialisht, ta ndryshojnë vargun, përmes proceseve të zakonshëm të shqyrtimit të kodit.
Gjendje e Përkthimeve
Ja gjendja e tanishme e përkthimeve. Nëse doni të nisni një përkthim në një gjuhë ende të panisur, ju lutemi, shkruajini listës së postimeve: onionshare-dev@lists.riseup.net
