Jak przesłać szablon

Zanim zaczniesz

Przed przesłaniem przygotuj dwie rzeczy.

1. Konto GitHub. Repozytorium szablonu musi być hostowane na GitHub. Jeśli nie masz konta, najpierw utwórz je.
2. Gotowy projekt. Upewnij się, że jesteś zadowolony z pliku .picopixel, zanim go prześlesz. Wyeksportuj go z aplikacji PicoPixel i przygotuj do dodania do repozytorium.

Przygotowanie repozytorium GitHub

Utwórz nowe publiczne repozytorium GitHub dla zgłoszenia szablonu. Repozytorium powinno zawierać trzy rzeczy:

1. Twój plik .picopixel

Umieść plik projektu .picopixel w katalogu głównym repozytorium. To właśnie ten plik ludzie pobiorą i otworzą w PicoPixel, więc upewnij się, że jest to finalna wersja.

2. Obrazy pokazowe

Dodaj obrazy, które chcesz pokazać obok szablonu w galerii. Pomagają one ludziom zobaczyć wygląd projektu przed pobraniem.

• Umieść obrazy w katalogu głównym repozytorium albo w folderze takim jak images/.
• Użyj popularnych formatów: .png, .jpg albo .webp.
• Dodaj co najmniej jeden zrzut ekranu projektu w działaniu. Kilka ujęć albo ekranów jest jeszcze lepsze.
• Zachowaj rozsądny rozmiar obrazów — na tyle duży, aby było widać szczegóły, ale bez niepotrzebnego nadmiaru.

3. README

Napisz README.md w katalogu głównym repozytorium. Ten plik jest używany jako opis szablonu w galerii, więc potraktuj go jak publiczną stronę szablonu.

Mocne README powinno zawierać:

• Czym jest szablon — krótkie podsumowanie projektu i jego przeznaczenia.
• Docelową rozdzielczość i hardware — płytkę albo wyświetlacz, dla którego został zbudowany, aby ludzie wiedzieli, czy pasuje do ich konfiguracji.
• Co zawiera — listę ekranów, widgetów i kluczowych funkcji. Na przykład: "dwa ekrany: dashboard główny i strona ustawień, z suwakami, przełącznikami i widgetem zegara."
• Credits — jeśli użyłeś zasobów firm trzecich, które masz prawo udostępniać, podaj ich nazwy i źródła.

Oto minimalny przykład:

# Weather Dashboard Template

A clean two-screen weather dashboard designed for 320×240 TFT displays.

## What's included

- **Home screen** — current temperature, humidity, and a 3-day forecast row
- **Settings screen** — unit toggle (°C/°F), update interval slider, and Wi-Fi status

## Built for

- 320×240 resolution
- ILI9341 or similar TFT displays

## Credits

Weather icons from [Meteocons](https://bas.dev/work/meteocons) (MIT license).

Wypełnianie formularza

Gdy repozytorium jest gotowe, przejdź do formularza zgłoszeniowego.

1. Otwórz aplikację PicoPixel i zaloguj się.
2. Kliknij swoje konto na dole lewego paska bocznego, a potem wybierz Your account.
3. W pasku bocznym konta otwórz Submit Template.

Formularz ma trzy pola:

• GitHub Repo Link — URL publicznego repozytorium GitHub (np. https://github.com/yourname/my-template). Repozytorium musi być publiczne, aby zespół recenzujący miał do niego dostęp. Przed wysłaniem sprawdź, czy zawiera plik .picopixel, obrazy i README.
• Author / Credits — nazwa, która ma być pokazana jako twórca szablonu. Dodaj też inne osoby, które powinny zostać wymienione.
• Notes (opcjonalnie) — wszystko, co zespół recenzujący powinien wiedzieć, a czego nie ma w README. Na przykład, jeśli niektóre obrazy nie powinny zostać użyte w wpisie galerii albo jeśli istnieje kontekst projektu, który nie pasuje do publicznego opisu.

Gdy wszystko wygląda dobrze, wyślij formularz.

Prawa i uprawnienia

Przesłanie szablonu udziela realnych uprawnień, więc przeczytaj tę część uważnie przed wysłaniem.

Przesyłając szablon, udzielasz PicoPixel pozwolenia na dostęp, pobranie i publiczną publikację zawartości repozytorium w społecznościowej galerii szablonów. Opublikowane szablony są udostępniane bez ograniczeń praw autorskich ani wymagań licencyjnych, aby każdy mógł swobodnie używać ich we własnych projektach, także komercyjnie. Twój credit jest pokazany, ale sam szablon jest darmowy do dowolnego użycia przez innych.

Oznacza to, że przesyłaj tylko prace, które chcesz udostępnić na takich warunkach. Jeśli jakakolwiek część projektu używa zasobu, którego nie stworzyłeś — fontu, zestawu ikon, obrazu albo czegokolwiek innego — i nie masz pewności, że możesz udostępnić go swobodnie i bez ograniczeń, usuń go przed przesłaniem. W razie wątpliwości pomiń go: czysty szablon jest dla innych znacznie bardziej użyteczny niż taki, który trzeba później wycofać.

PicoPixel może usuwać treści naruszające prawa osób trzecich. Zobacz Regulamin.

Co dzieje się później

Po wysłaniu zespół PicoPixel klonuje repozytorium i sprawdza szablon. Recenzja potwierdza, że plik .picopixel otwiera się poprawnie, obrazy i README są odpowiednie, a zgłoszenie spełnia Regulamin.

Zespół może odezwać się, jeśli coś wymaga wyjaśnienia albo poprawy. Gdy szablon przejdzie recenzję, zostaje opublikowany w galerii Templates z pokazanym credit i opisem z README. Od tego momentu każdy może otworzyć go jako punkt startowy własnego projektu.

Jeśli opublikowany szablon trzeba kiedyś poprawić albo usunąć (Twój lub cudzy), zobacz Jak zgłosić treść.

Dokąd dalej

• Templates gallery, przeglądaj szablony społeczności
• How to submit a pet, udostępnij animowany sprite
• How to report content, zgłoś problem ze zwierzakiem albo szablonem
• Terms, zasady dotyczące zgłoszeń