Nejlepším místem, kde začít s jakýmkoli příspěvkem do open source, je něco, co odpovídá vašim znalostem, zkušenostem a oblasti zájmu.

Než začnete

Než začnete přispívat, může vám pomoci získat představu o projektu. jako celek. Pokud jste ještě neprovedli BeeWare Tutorial, začněte tam. To vám poskytne seznámíte s nejdůležitějšími nástroji BeeWare, takže uvidíte, jak se používají. do sebe zapadají.

Jakmile dokončíte tento výukový program, budete připraveni vybrat si něco, co se vám bude hodit. na čem budete pracovat. Pokud jste měli nějaké problémy při provádění výukového kurzu - pokud jste narazili na problém. chybu, nebo pokud vám nebyl jasný jazyk použitý k popisu nějakého kroku - to je chyba, která se objevila při skvělé místo, kde začít! Pokud můžete své zkušenosti proměnit v výukového programu, další osoba, která bude výukový program provádět, už nebude muset nenarazí na stejný problém.

Pokud však vaše výuka proběhla zcela hladce (a my doufáme, že se vám to podařilo). byla!), zde je několik nápadů, kde se můžete zapojit, v závislosti na vašich dovednostech a zájmech.

Programování v jazyce Python

Kufřík

Pokud chcete přispět k nástroji, který má jasně definovaný problém. ale potřebuje odstranit chyby a přidat funkce, Briefcase může být projektem právě pro vás. pro vás. Briefcase je nástroj pro zabalení projektu v jazyce Python do samostatného balíčku. GUI aplikace. Přijímá konfigurační soubor pyproject.toml a použije tato konfigurační data k vygenerování instalátorů nebo distribuovatelných souborů. aplikačních balíčků.

Aktovka vydání tracker má sbírku návrhů funkcí (a menší počet chyb). Pokud je to váš poprvé, vyhledejte jeden z lístků označených jako good první issue -. Jedná se o témata, která byla speciálně vybrána pro první vydání. přispěvatele, protože by měly být relativně jednoduché na implementovat. Může se vám také hodit filtrování tiketů pro tzv. platformu, kterou skutečně používáte pro vývoj - bude obtížné opravit linuxovou chybu, pokud nemáte linuxový počítač, který byste mohli použít k testování!

Pokud chcete přispět na konkrétní projekt, můžete také vyfiltrovat první dobré otázky podle konkrétních projektů pomocí těchto odkazů:

Vyberte si tiket, zanechte komentář, že se problémem zabýváte, a. a zkuste vytvořit požadavek na stažení, který by implementoval opravu!

Programování grafického uživatelského rozhraní

Pokud máte zkušenosti s nativní knihovnou widgetů - Cocoa v systému MacOS, GTK+ v Linuxu, Windows Forms nebo nativními knihovnami pro iOS či Android, možná budete moci pomoci s Toga. Toga je multiplatformní sada nástrojů pro widgety - poskytuje společné rozhraní pro prvky uživatelského rozhraní, jako jsou tlačítka a stromy.

Toga má již definovanou řadu rozhraní, nicméně. implementace těchto rozhraní není na všech platformách úplná. Vyberte si widget a implementujte jej pro zvolenou platformu!

I když neznáte nativní knihovnu widgetů, můžete být schopni pomoci s aplikací Toga. Psaní nových widgetů je mnohem méně komplikované, než je tomu u se může zdát. Každá platforma má dokumentaci, jak používat její nativní API, a proces překladu dokumentace této platformy z angličtiny do češtiny je velmi obtížný. jiného jazyka (např. Objective C nebo C#) je relativně jednoduchý. jednoduchý proces. Existující kód by vám měl poskytnout několik vodítek jak to lze provést, a tým BeeWare vám rád pomůže, pokud si budete budete potřebovat. Skočte na BeeWare Discord a uděláme cokoli. můžeme pomoci!

Pokud se vám nechce převádět kód z jednoho jazyka do druhého - vždycky je tu sada testů. Jádro knihovny Toga má také testovací sadu sadu testů, ale její pokrytí není příliš dobré. Vyberte si rozhraní widgetu a zkuste pro něj napsat test!

Dokumentace

Kvalitní dokumentace je základem každého úspěšného projektu. Víme, že Toga a Kufřík potřebují značnou zlepšit jejich dokumentaci. Výukový program máte za sebou, nyní se věnujte podívejte se na dokumentaci k Toga a Toga. Aktovka a zjistěte, zda najdete jak vylepšit návody, odkazy a průvodce tématy, které jsou v nich obsaženy. v nich.

Výukové programy

Jedním z nejlepších způsobů, jak přispět, je ujistit se, že naše úvodní a. výuková dokumentace byla pevná jako skála. Vyberte si projekt, který vás zajímá BeeWare a snažte se postupovat podle úvodní příručky a návodu k projektu. výukového programu. Pokud nemůžete najít úvodní příručku - pak je to tak. první věc, kterou je třeba nahlásit!

Při práci s výukovým programem si všímejte všeho, co se vám nezdá. nedává smysl nebo nefunguje. Poté otevřete hlášení o chybách, které se týkají těchto problémů.

Windows

Pokud jste uživatelem systému Windows, BeeWare vaši pomoc rozhodně využije. Stránky všichni členové hlavního týmu používají při každodenním vývoji Linux a MacOS, a jako je proto opravdu snadné, aby se nekompatibilita se systémem Windows dostala do hry. Tento je téměř vždy způsobeno nedopatřením. Identifikace - a možná i problémy s provozem nástrojů BeeWare v systému Windows je nesmírně náročné. pomoc.

Jazyky

Mluvíte jiným jazykem než anglicky? V současné době je hlavní tým všichni rodilí mluvčí angličtiny. Poskytování překladů dokumentace nebo zcela nových návodů či průvodců ve vašem rodném jazyce. je skvělý způsob, jak přispět. Vyberte si projekt, který již má dokumentaci a přeložte tento text. Případně začněte od začátku a napište zcela nový návod.

Pokud mluvíte jazykem s jinou než latinskou znakovou sadou (např. ruština nebo nebo jazykem s písmem zprava doleva (např. hebrejština nebo čínština). arabština), budete moci poukázat na všechna místa, kde jsme předpokládali, že je písmo jednoduchého kódování ASCII nebo konvencí zleva doprava. Vyberte si některou z těchto možností aktivních projektů BeeWare a zkuste jej použít s použitím svého rodného jazyka. jazyka. Pokud narazíte na nějaké problémy, nahlaste je jako chyby; pokud se vám se cítíte obzvlášť odvážně, zkuste zjistit, jak se dá opravit chybu.

Praktické použití

Jedním z nejlepších způsobů, jak zjistit, kde jsou naše mezery - jak v případě a API - je, aby lidé skutečně používali BeeWare k sestavování aplikací. něco vytvářet. Pokud vám tedy žádný z dosavadních nápadů nepřipadá zajímavý, proč ne. nezkusíte něco vlastního? Použijte sadu BeeWare k vytvoření takové aplikace kterou jste vždycky chtěli - desktopovou vizualizaci datového zdroje nebo aplikaci, která by se dala mobilní aplikaci pro sledování vašich aktivit - ať už je to cokoli, zkuste to. vytvořit.

Můžeme vám téměř zaručit, že narazíte na problémy. BeeWare je stále velmi mladý projekt. Ale problémy, na které narazíte, nám poskytnou velkou naznačí, co je třeba řešit. Naznačí nám, jaké widgety potřebujeme a jakou dokumentaci je třeba zlepšit. Takže jakmile narazíte na problémy při vytváření vlastní aplikace, zaznamenávejte problémy s projekty BeeWare. které problémy způsobily. To nám umožní zjistit, co je třeba zlepšit - a může to být i zdrojem inspirace pro vás. přispět!