Przejdź do treści

📘 Instrukcja dla Edytorów ChargerWiki

Witaj w zespole edytorów! 👋 Ten przewodnik przeprowadzi Cię krok po kroku przez proces dodawania i edycji treści na ChargerWiki. Nie musisz znać się na programowaniu - wystarczy umiejętność pisania tekstu!

🎯 Zanim zaczniesz

Co potrzebujesz:

  • ✅ Konto na GitHub (darmowe) - Załóż tutaj
  • ✅ Przeglądarkę internetową (Chrome, Firefox, Safari, Edge)
  • ✅ Nic więcej! Nie instalujesz żadnych programów

Jak to działa:

  1. Logujesz się do panelu edycyjnego przez przeglądarkę
  2. Edytujesz tekst jak w Wordzie (prawie!)
  3. Wysyłasz do sprawdzenia - administrator zatwierdzi Twoje zmiany
  4. Twoja treść trafia na stronę! 🎉

🚀 KROK 1: Pierwsze logowanie

1.1 Wejdź na stronę panelu

Otwórz przeglądarkę i wpisz adres: 

https://charger-wiki.pages.dev/admin/

1.2 Zaloguj się przez GitHub

  1. Zobaczysz niebieski przycisk "Login with GitHub"
  2. Kliknij go
  3. Zaloguj się na swoje konto GitHub (wpisz login i hasło)
  4. GitHub zapyta: "ChargerWiki CMS wants to access your account"
  5. Kliknij zielony przycisk "Authorize" (Autoryzuj)

Gratulacje! 🎊 Jesteś zalogowany. To musisz zrobić tylko raz.

✏️ KROK 2: Edycja istniejącego artykułu

2.1 Znajdź artykuł

Po lewej stronie ekranu zobaczysz listę kategorii z ikonkami: - 🚀 04 - Silniki - ⚙️ 05 - Skrzynia i Napęd - 🔧 02 - Konserwacja - ...itd.

Kliknij na kategorię, która Cię interesuje (np. "🚀 04 - Silniki").

2.2 Wybierz artykuł do edycji

Zobaczysz listę artykułów w tej kategorii: - 3.6_pentastar.md - 5.7_hemi.md - 6.4_srt.md

Kliknij na artykuł, który chcesz edytować.

2.3 Edytuj treść

Zobaczysz edytor podzielony na dwie części: - Lewa strona - tutaj piszesz i edytujesz tekst - Prawa strona - podgląd jak będzie wyglądać na stronie

Teraz możesz edytować tekst!

Podstawowe formatowanie: 

# Duży nagłówek
## Średni nagłówek
### Mały nagłówek

**Pogrubiony tekst**
*Tekst kursywą*

- Lista punktowana
- Punkt drugi
- Punkt trzeci

1. Lista numerowana
2. Punkt drugi
3. Punkt trzeci

[Link do strony](https://example.com)
![Zdjęcie](../assets/foto.jpg)

2.4 Zapisz zmiany

  1. Gdy skończysz edycję, kliknij przycisk "Save" (na górze)
  2. Twoja praca jest zapisana jako szkic (draft)

2.5 Wyślij do sprawdzenia

Gdy skończysz i wszystko wygląda dobrze: 1. Po prawej stronie znajdź sekcję "Status" 2. Kliknij "Set status" → "In review" 3. Gotowe! 🎉

Administrator zostanie powiadomiony i sprawdzi Twoje zmiany przed publikacją.

➕ KROK 3: Dodawanie nowego artykułu

3.1 Wybierz kategorię

Po lewej stronie kliknij kategorię, do której chcesz dodać nowy artykuł.

3.2 Utwórz nowy artykuł

Na górze ekranu zobaczysz przycisk: "New [nazwa kategorii]" (np. "New Silniki")

Kliknij go.

3.3 Wypełnij formularz

Zobaczysz puste pola: - Tytuł - wpisz tytuł artykułu (np. "Wymiana oleju w silniku 5.7 Hemi") - Treść - tutaj piszesz cały artykuł

3.4 Napisz artykuł

Pisz normalnie jak w edytorze tekstu. Możesz używać formatowania (patrz punkt 2.3).

3.5 Zapisz i wyślij

  1. Kliknij "Save" aby zapisać szkic
  2. Kliknij "Set status" → "In review" aby wysłać do sprawdzenia

🖼️ KROK 4: Dodawanie zdjęć

4.1 Kliknij ikonę zdjęcia

W edytorze (nad polem tekstowym) znajdź ikonę obrazka 🖼️ lub kliknij przycisk "+".

4.2 Wybierz zdjęcie

  1. Przeciągnij plik z komputera na okno LUB
  2. Kliknij "Choose an image" i wybierz plik z dysku

4.3 Gotowe!

Zdjęcie zostanie automatycznie dodane do tekstu: 

![Opis zdjęcia](../assets/nazwa-zdjecia.jpg)

Ważne: Zdjęcia powinny być: - Format: JPG, PNG - Rozmiar: maksymalnie 2 MB (najlepiej poniżej 500 KB) - Dobra jakość, ostre i czytelne

🤖 POMOC: Prompty dla AI (ChatGPT, Claude)

Prompt #1: Pomoc przy edycji tekstu (styl i jakość)

Jeśli piszesz artykuł i chcesz upewnić się, że pasuje stylistycznie do wiki, skopiuj ten prompt do ChatGPT/Claude:

Jestem edytorem ChargerWiki - wiki technicznej o Dodge Charger 2011-2014.

Potrzebuję pomocy w edycji artykułu, aby był:
- Spójny stylistycznie z resztą wiki (techniczny, konkretny, bez marketingowego bełkotu)
- Fachowy ale zrozumiały dla hobbystów
- W języku polskim
- Skoncentrowany na praktycznych informacjach (momenty dokręcania, numery części, procedury)

Styl wiki:
- Zwięzły i konkretny
- Używamy tabel dla specyfikacji technicznych
- Używamy ostrzeżeń (!!! warning) dla ważnych informacji
- Używamy uwag (!!! note) dla dodatkowych wskazówek
- Numery części w formacie: "Mopar 68123456AA"
- Momenty dokręcania w Nm

Oto mój tekst do sprawdzenia:

[WKLEJ TUTAJ SWÓJ TEKST]

Proszę:
1. Popraw styl aby pasował do wiki
2. Wskaż błędy merytoryczne (jeśli znasz temat)
3. Zasugeruj lepszą strukturę (jeśli potrzeba)
4. Sprawdź czy formatowanie Markdown jest poprawne

Prompt #2: Pomoc przy obsłudze panelu CMS

Jeśli masz problem z panelem edycyjnym, skopiuj ten prompt do ChatGPT/Claude:

Używam DecapCMS (panel edycyjny) dla ChargerWiki.

Mam problem z: [OPISZ PROBLEM]

Panel dostępny pod: https://charger-wiki.pages.dev/admin/
System: DecapCMS v3 z editorial workflow
Backend: GitHub
Format: Markdown

Jak mogę rozwiązać ten problem krok po kroku?

Przykłady problemów: - "Nie mogę dodać zdjęcia" - "Jak dodać tabelę w Markdown?" - "Jak zrobić link do innego artykułu w wiki?" - "Przycisk Save jest wyszarzony"

⚠️ WAŻNE: Proces zatwierdzania (moderacja)

Twoje zmiany NIE trafiają od razu na stronę!

Dlaczego? Administrator sprawdza każdą zmianę przed publikacją, aby zapewnić: - ✅ Poprawność merytoryczną - czy informacje są zgodne z faktami - ✅ Bezpieczeństwo - czy porady nie są niebezpieczne - ✅ Jakość - czy tekst jest zrozumiały i dobrze napisany - ✅ Spójność - czy pasuje stylistycznie do reszty wiki

🔍 Audyt krzyżowy z AI

Administrator używa agentów AI do weryfikacji Twoich zmian:

  1. Sprawdzanie faktów - AI porównuje Twoje informacje z:
  2. Oficjalną dokumentacją techniczną Chrysler/Dodge
  3. Service Bulletins (TSB)

  4. Forum posts i potwierdzone źródła

  5. Weryfikacja numerów części - czy podane numery Mopar/OEM są prawidłowe

  6. Sprawdzanie momentów dokręcania - czy wartości są zgodne z Factory Service Manual

  7. Kontrola bezpieczeństwa - czy procedury nie są niebezpieczne

Nie przejmuj się! To nie jest krytyka Twojej pracy - to po prostu standardowy proces kontroli jakości, który zapewnia, że wiki jest wiarygodna i pomocna dla wszystkich użytkowników.

Co się dzieje z Twoimi zmianami:

  1. Wysyłasz do sprawdzenia ("In Review")
  2. Administrator widzi Twoją zmianę w panelu
  3. Audyt AI - automatyczna weryfikacja faktów
  4. Administrator sprawdza - może:
  5. ✅ Zatwierdzić bez zmian
  6. ✏️ Wprowadzić drobne poprawki (np. literówki, formatowanie)
  7. 💬 Poprosić Cię o zmiany (dostaniesz komentarz)
  8. ❌ Odrzucić (z wyjaśnieniem dlaczego)
  9. Publikacja - zmiana trafia na stronę

Typowy czas zatwierdzenia: 1-3 dni robocze

📋 Checklist przed wysłaniem do sprawdzenia

Zanim klikniesz "Set status: In review", sprawdź:

  • [ ] Ortografia - przeczytałem tekst, brak literówek
  • [ ] Zdjęcia działają - widzę je w podglądzie
  • [ ] Linki działają - kliknąłem i sprawdziłem
  • [ ] Tabele są poprawne - wyświetlają się dobrze
  • [ ] Numery części są poprawne - sprawdziłem w katalogu Mopar
  • [ ] Momenty dokręcania - potwierdziłem w oficjalnej dokumentacji
  • [ ] Podałem źródła - jeśli to możliwe, podałem skąd mam informacje

🆘 Pomoc i kontakt

Masz pytanie? Problem?

  1. Sprawdź sekcję FAQ (poniżej)
  2. Użyj promptu AI (punkt "Pomoc przy obsłudze panelu")
  3. Zapytaj na grupie Facebook: Dodge Charger 2011-2014 PL
  4. Napisz do administratora - przez GitHub Issues: https://github.com/leszek-moryto/charger-wiki/issues

❓ FAQ - Najczęściej zadawane pytania

Q: Jak długo czeka moja zmiana na zatwierdzenie?

A: Zazwyczaj 1-3 dni robocze. Administrator dostaje powiadomienie i sprawdza zmiany regularnie.

Q: Czy mogę edytować swój artykuł po wysłaniu do sprawdzenia?

A: Tak! Dopóki administrator nie zatwierdził, możesz wracać i edytować. Pamiętaj żeby zapisać (Save).

Q: Dlaczego moja zmiana została odrzucona?

A: Administrator pozostawia komentarz z wyjaśnieniem. Najczęstsze powody: - Błędne informacje techniczne - Brak źródeł dla kontrowersyjnych twierdzeń - Niebezpieczne porady - Duplikacja treści (to samo już jest w wiki)

A: Użyj relatywnej ścieżki: 

[Przejdź do artykułu o silniku](../04_silniki/3.6_pentastar.md)

Q: Jak zrobić tabelę?

A: Użyj składni Markdown: 

| Nagłówek 1 | Nagłówek 2 |
| :--------- | :--------- |
| Komórka 1  | Komórka 2  |
| Komórka 3  | Komórka 4  |

Q: Czy mogę kopiować tekst z innych stron?

A: NIE! To naruszenie praw autorskich. Możesz: - ✅ Napisać własnymi słowami - ✅ Sparafrazować (ale podać źródło) - ✅ Cytować krótkie fragmenty (w cudzysłowie + źródło)

Q: Jak dodać ostrzeżenie (żółte pudełko)?

A: Użyj składni: 

!!! warning "Uwaga!"
    To jest ważne ostrzeżenie dla użytkownika.

Q: Jak dodać notatkę (niebieskie pudełko)?

A: Użyj składni: 

!!! note "Wskazówka"
    Dodatkowa informacja dla czytelnika.

Q: Czy muszę znać Markdown?

A: Podstawy (pogrubienie, nagłówki, listy) wystarczą. Reszty nauczysz się w trakcie. Zawsze możesz zapytać AI o pomoc!

Q: Co jeśli nie mam konta GitHub?

A: Załóż je za darmo na https://github.com/signup - zajmie to 2 minuty.

Q: Czy mogę używać AI (ChatGPT) do pisania artykułów?

A: Tak, ALE: - ✅ Możesz używać AI do pomocy (formatowanie, sprawdzanie stylu) - ⚠️ Musisz zweryfikować fakty - AI czasem się myli! - ⚠️ Musisz zredagować tekst żeby brzmiał naturalnie - ❌ Nie kopiuj na ślepo - administrator to wyłapie w audycie

🎓 Przykładowy workflow (krok po kroku)

Przykład: Chcę dodać artykuł o wymianie oleju

Krok 1: Loguję się

https://charger-wiki.pages.dev/admin/ → Login with GitHub

Krok 2: Tworzę nowy artykuł

Kategoria: 02 - Konserwacja → New Konserwacja

Krok 3: Wypełniam

Tytuł: Wymiana oleju silnikowego - procedura
Treść: [Piszę artykuł]

Krok 4: Dodaję zdjęcia

Klikam ikonę obrazka → Wybieram foto z dysku

Krok 5: Sprawdzam z AI (opcjonalnie)

Kopiuję tekst → Wklejam do ChatGPT z promptem #1 → Poprawiam

Krok 6: Zapisuję i wysyłam

Save → Set status: In review

Krok 7: Czekam na feedback

Administrator sprawdza → Mogę dostać komentarz lub zatwierdzenie

Krok 8: Publikacja

Administrator publikuje → Artykuł jest LIVE! 🎉

🏆 Dobre praktyki dla edytorów

✅ DO (rób to):

  • Pisz konkretnie i zwięźle
  • Podawaj źródła (jeśli masz)
  • Używaj tabel dla specyfikacji technicznych
  • Dodawaj zdjęcia (ostre, dobre jakości)
  • Sprawdzaj ortografię przed wysłaniem
  • Pytaj jeśli masz wątpliwości

❌ DON'T (unikaj):

  • Kopiowanie tekstu z innych stron
  • Pisanie opinii zamiast faktów ("moim zdaniem...", "najlepszy...")
  • Podawanie niesprawdzonych informacji
  • Używanie wulgarnego języka
  • Marketingowe teksty ("rewelacyjny produkt!")
  • Bardzo duże zdjęcia (>2 MB)

💡 Ostatnia rada

Nie bój się popełniać błędów!

Administrator jest po to, żeby pomóc i poprawić. Każdy edytor się uczy. Najważniejsze to: - Starać się jak najlepiej - Sprawdzać fakty - Pytać gdy masz wątpliwości

Dziękujemy, że pomagasz budować ChargerWiki! 🙏🚗

Wersja: 1.0 Data aktualizacji: 2026-02-15 Pytania? Pisz na grupie Facebook lub GitHub Issues