Przeglądanie Kompendium
Ten artykuł opisuje możliwości przeglądania Kompendium.
***
Treści w Kompendium prezentują strukturę hierarchiczną: artykuły zawierają inne artykuły. Jeden artykuł może być tylko w jednym artykule.
Artykuł należy zawsze do jednego z następujących rodzajów artykułu:
- artykuł zwykły (dla moderacji: tworzony na stronie o szablonie "show");
- kategoria artykułów (dla moderacji: tworzony na stronie o szablonie "category");
- strona główna bloga Serwisu 4programmers.net (dalej w skrócie: "Serwis") (dla moderacji: tworzony na stronie o szablonie "blog.home");
- strona główna "Pomocy" Serwisu (dla moderacji: tworzony na stronie o szablonie "help.home");
- artykuł "Pomocy" Serwisu (dla moderacji: tworzony na stronie o szablonie "help.show").
Użytkownik może korzystać z funkcjonalności Kompendium za pomocą jednego z następujących widoków:
- widok Kompendium (patrz niżej);
- widok artykułu (patrz niżej);
- widok tworzenia lub edycji artykułu;
- widok historii edycji artykułu (patrz niżej).
Widok Kompendium
Widok kompendium użytkownik może wyświetlić, naciskając przycisk z etykietą "Kompendium" w menu głównym Serwisu. Widok ten zawiera:
- listę artykułów, umożliwiającą przeglądanie artykułów do pierwszego poziomu zagnieżdżenia włącznie;
- panel "Ostatnie zmiany w tekstach" (patrz niżej).
Panel "Ostatnie zmiany w tekstach"
Panel "Ostatnie zmiany w tekstach" umożliwia przeglądanie edycji artykułów. Zawiera on stronicowaną tabelę; każdy jej wiersz odnosi się do jednej edycji jednego artykułu. Tabela zawiera następujące kolumny:
- "Użytkownik", której każdy wiersz zawiera nazwę użytkownika, który dokonał edycji;
- "Komentarz", której każdy wiersz zawiera nazwę edytowanego artykułu, będącą linkiem do niego, oraz komentarz użytkownika, który dokonał edycji;
- "Rozmiar", TODO: ?;
- "Różnica", której każdy wiersz zawiera różnicę między rozmiarem wersji artykułu sprzed edycji a rozmiarem jego wersji po edycji, w bajtach;
- "Data modyfikacji", której każdy wiersz zawiera czas dokonania edycji.
Widok artykułu
Widok artykułu użytkownik może wyświetlić, naciskając dowolny link prowadzący do tego artykułu. Widok ten zawiera:
- menu artykułu (patrz niżej);
- sekcję treści artykułu (patrz niżej);
- w przypadku każdego rodzaju artykułu poza stroną główną "Pomocy" Serwisu: sekcję artykułów, które artykuł zawiera (patrz niżej);
- w przypadku artykułu zwykłego i artykułu "Pomocy" Serwisu: sekcję komentarzy (patrz niżej);
- w przypadku artykułu zwykłego: sekcję "O autorze"; znajduje się ona na pasku bocznym;
- w przypadku artykułu zwykłego: sekcję "Stronę współtworzą" (patrz niżej);
- w przypadku artykułu zwykłego: sekcję "Strony powiązane" (patrz niżej);
- w przypadku strony głównej bloga Serwisu: sekcję kontaktu z Serwisem; znajduje się ona na pasku bocznym;
- w przypadku artykułu "Pomocy" Serwisu: listę artykułów "Pomocy" Serwisu; znajduje się ona na pasku bocznym.
Menu artykułu
Menu artykułu znajduje się w następujących miejscach, w zależności od rodzaju artykułu:
- w przypadku kategorii artykułów: nad sekcją treści artykułu;
- w przypadku artykułu zwykłego: na pasku bocznym.
Menu danego artykułu zawiera:
- przycisk z etykietą "Edycja"; naciśnięcie przycisku przenosi użytkownika do widoku tworzenia lub edycji tego artykułu;
- przycisk – w przypadku artykułu zwykłego z etykietą "Nowa strona", a w przypadku kategorii artykułów z etykietą "Napisz nowy artykuł w tym dziale"; naciśnięcie przycisku przenosi użytkownika do widoku tworzenia lub edycji nowego artykułu w tym artykule;
- przycisk dodawania lub usuwania artykułu z "ulubionych";
- przycisk z etykietą "Historia i autorzy"; naciśnięcie przycisku przenosi użytkownika do widoku historii edycji tego artykułu (patrz niżej).
Sekcja treści artykułu
Sekcja treści artykułu zawiera:
- tytuł artykułu, będący linkiem do niego;
- w przypadku artykułu zwykłego: nazwę użytkownika, który utworzył artykuł, będącą linkiem do profilu tego użytkownika;
- w przypadku artykułu zwykłego: sekcję informacji o artykule;
- treść artykułu.
Sekcja informacji o artykule
Sekcja informacji o artykule zawiera:
- czas utworzenia artykułu;
- czas ostatniej edycji artykułu;
- przycisk, umożliwiający przewinięcie widoku do sekcji komentarzy artykułu; zawiera on ikonę dwóch dymków komiksowych i etykietę zawierającą liczbę komentarzy;
- liczbę odsłon (TODO – co to są te odsłony?) artykułu.
Sekcja artykułów, które artykuł zawiera
Sekcja artykułów, które dany artykuł zawiera, zawiera:
- w przypadku kategorii artykułów: listę, której każda pozycja jest linkiem do jednego artykułu; jej pozycje odnoszą się do tych artykułów w tym artykule, które same zawierają co najmniej jeden artykuł; każda pozycja tej listy zawiera nazwę artykułu oraz sumaryczną liczbę artykułów (uwzględniającą wszystkie poziomy zagnieżdżenia).
- listę, której każda pozycja jest linkiem do jednego artykułu; jej pozycje odnoszą się do tych artykułów w danym artykule, z których żaden sam nie zawiera artykułów; jest ona stronicowana.
Sekcja komentarzy
Sekcja komentarzy w danym artykule zawiera:
- liczbę komentarzy do tego artykułu; informacja: liczba ta nie jest odświeżana przy dodaniu nowego komentarza, a przy ładowaniu strony;
- formularz tworzenia komentarza;
- listę komentarzy do tego artykułu.
Komentarz
Komentarz zawiera:
- awatar użytkownika, który utworzył komentarz; awatar ten jest linkiem do widoku profilu tego użytkownika;
- w nagłówku: nazwę użytkownika, który utworzył komentarz; nazwa ta jest linkiem do widoku profilu tego użytkownika
- w nagłówku: czas utworzenia komentarza;
- treść komentarza;
- przycisk z ikoną strzałki w dół, umożliwiający wyświetlenie pop-up panelu zawierającego menu tego komentarza (patrz niżej).
Menu komentarza do artykułu
Menu komentarza do artykułu zawiera:
- pozycję "Edytuj" – umożliwiającą edycję komentarza; więcej informacji: artykuł Tworzenie i edycja artykułów i komentarzy, sekcja "Edycja komentarza";
- pozycję "Usuń" – umożliwiającą usunięcie komentarza; więcej informacji: artykuł Usuwanie artykułów i komentarzy, sekcja "Usunięcie komentarza".
Sekcja "Stronę współtworzą"
Sekcja "Stronę współtworzą" zawiera listę użytkowników, którzy edytowali (lub utworzyli) dany artykuł. Każda pozycja tej listy odnosi się do jednego użytkownika i zawiera:
- awatar tego użytkownika wraz z jego nazwą, będące w całości linkiem do profilu tego użytkownika;
- procentowy udział edycji tego użytkownika w sumie wszystkich edycji artykułu (liczonej wraz z utworzeniem artykułu).
Sekcja "Strony powiązane"
Sekcja "Strony powiązane" zawiera listę linków do takich treści w Serwisie, które swoją treścią nawiązują do aktualnie przeglądanego artykułu. Podczas ustalania odpowiedniości brane są pod uwagę:
- wystąpienia słów kluczowych w tytule artykułu (większy priorytet);
- treść artykułu.
Patrz też: Strony podobne oraz powiązane
Widok historii edycji artykułu
Widok historii edycji danego artykułu użytkownik może wyświetlić, naciskając przycisk z etykietą "Historia i autorzy" w menu tego artykułu (patrz wyżej). Widok ten zawiera:
- listę edycji artykułu (patrz niżej);
- zielony przycisk z etykietą "Porównaj wersje", umożliwiający porównanie wersji artykułu odnoszących się do dwóch wybranych edycji.
Lista edycji artykułu
Lista edycji artykułu ujęta jest w postaci tabeli. Każdy wiersz tej tabeli odnosi się do jednej edycji. Tabela ta zawiera następujące kolumny:
- "R1", której każdy wiersz zawiera pole umożliwiające określenie, czy do porównania ma zostać dodana jako pierwsza edycja, do której odnosi się ten wiersz (pole niedostępne w przypadku braku edycji artykułu);
- "R2", której każdy wiersz zawiera pole umożliwiające określenie, czy do porównania ma zostać dodana jako druga edycja, do której odnosi się ten wiersz (pole niedostępne w przypadku braku edycji artykułu);
- "Użytkownik", której każdy wiersz zawiera nazwę użytkownika, który dokonał edycji, będącą linkiem do jego profilu;
- "Komentarz", której każdy wiersz zawiera komentarz użytkownika, który dokonał edycji;
- "Rozmiar", TODO: ?;
- "Różnica", której każdy wiersz zawiera różnicę między rozmiarem wersji artykułu sprzed edycji a rozmiarem jego wersji po edycji, w bajtach;
- "Data modyfikacji", której każdy wiersz zawiera czas edycji.