# WebBook

**WebBook** umożliwia generowanie stron internetowych, z pliku genealogicznego, które można umieścić lokalnie, na prywatnym pendrive, aby udostępnić je krewnym, lub na publicznej stronie internetowej.

Komentarz od użytkownika:

> Ta mała książka jest naprawdę wygodna, przyjemna w użyciu i wystarczająco kompletna, by przejrzeć swoją genealogię.  
> Może nie potrafię poprawnie korzystać z innych programów genealogicznych, ale kiedy eksportowałem w nich do sieci, wynik był ostry i mniej intuicyjny.

[![en-webbook.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook.png)

Jeśli nie chcesz umieszczać swojego drzewa genealogicznego i danych na stronie internetowej, nie ma problemu, możesz zrobić lokalną kopię na dowolnym nośniku (dysk twardy, pendrive...) i przeglądać ją w dowolnej przeglądarce internetowej.

## <span class="mw-headline">Opis</span>

Poprzedni obrazek to przykład WebBooka z drzewem rodzinnym Kennedy'ów.

Fragment strony ze szczegółami osób wygląda tak:

[![en-webbook-details.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-details.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-details.png)

<p class="callout warning">WebBook współpracuje z widokiem mapy, jeśli chcesz wygenerować mapę.</p>

## <span class="mw-headline">Nawigacja po wygenerowanych stronach</span>

Wygenerowane strony tworzą sekcje „książki internetowej”. Wiele sekcji jest dostępnych ze strony głównej, a część treści można dostosować.

**<span style="color: #008080;">Nazwiska</span>:** ta sekcja wyświetla listę nazwisk i częstotliwość ich występowania w drzewie genealogicznym.

<span style="color: #008080;">**Lista osób**</span>: ta sekcja wyświetla wszystkie osoby w drzewie w kolejności alfabetycznej.

<span style="color: #008080;">**Szczegóły osób**</span>: ta sekcja zawiera szczegółowy opis wszystkich osób. Dla każdej osoby znajdują się informacje o urodzeniu, małżeństwach i innych wydarzeniach. Szczegóły obejmują także dziadków, rodziców, przyrodnie rodzeństwo, małżeństwa, dzieci, relacje (chrzestni, świadkowie itp.) oraz notatki. Sekcja ta wyświetla do pięciu zdjęć lub mediów związanych z daną osobą lub jej małżeństwami. Przy każdym wydarzeniu ikona źródła pokazuje, czy istnieje źródło. Wystarczy kliknąć ikonę, aby je zobaczyć. Obrazy i media źródeł nie są wyświetlane w tej sekcji, lecz w sekcji **źródła**.

<span style="color: #008080;">**Źródła**</span>: pierwsza strona tej sekcji pokazuje listę wszystkich źródeł genealogii. Kolejne strony zawierają szczegóły każdego źródła. Szczegóły źródła obejmują, jeśli dostępne, tekst źródła oraz obrazy i media źródła oraz powiązanych osób i rodzin. Jeśli media nie są obrazem, dokument uznaje się za innego rodzaju i wyświetlany jest obraz reprezentujący plik multimedialny. Kliknięcie obrazu otwiera dokument źródłowy w oryginalnym rozmiarze lub uruchamia media (dźwięk, wideo itp.).

<span style="color: #008080;">**Zdjęcia i inne media**</span>: pierwsza strona tej sekcji pokazuje listę wszystkich mediów w genealogii powiązanych z osobami i rodzinami. Kolejne strony zawierają obrazy tych mediów w formie albumu zdjęć. Sekcja ta nie zawiera materiałów źródłowych. Jeśli media nie są obrazem, dokument uznaje się za innego rodzaju i wyświetlany jest obraz reprezentujący plik multimedialny. Kliknięcie obrazu otwiera dokument źródłowy w oryginalnym rozmiarze lub uruchamia media (dźwięk, wideo itp.). Jeśli media nie zostaną znalezione, pojawia się obraz wskazujący na to, co pozwala poprawić genealogię, jeśli to konieczne.

<span style="color: #008080;">**Mapa geograficzna**</span>: ta sekcja pokazuje mapę geograficzną z lokalizacją wszystkich miast zidentyfikowanych w drzewie genealogicznym. Mapa jest interaktywna i można ją powiększać, pokazywać przodków lub kuzynów, urodzenia, małżeństwa, zgony lub wydarzenia z wybranego okresu lat. Klikając na miasto, zobaczysz podstawowe informacje o wydarzeniach, które tam miały miejsce. Mapy działają tylko wtedy, gdy współrzędne lokalizacji istnieją i są poprawne. Zaleca się sprawdzenie [widoku mapy geograficznej](https://docs.ancestris.org/books/user-guide/page/geographic-map "Mapa geograficzna").

<span style="color: #008080;">**Lista miast**</span>: ta sekcja pokazuje listę miast, w których miało miejsce przynajmniej jedno wydarzenie z drzewa genealogicznego.

<span style="color: #008080;">**Szczegóły miast**</span>: ta sekcja pokazuje dla każdej lokalizacji wszystkie wydarzenia, które tam miały miejsce. Jeśli wygenerowano mapę, mała ikona może pokazać lokalizację miasta na mapie.

<span style="color: #008080;">**Kalendarz rodzinny**</span>: ta sekcja pokazuje dni w roku, kiedy miało miejsce przynajmniej jedno wydarzenie z drzewa genealogicznego.

<span style="color: #008080;">**Szczegóły kalendarza**</span>: ta sekcja pokazuje dla każdego dnia w roku wszystkie wydarzenia, które się wtedy odbyły.

**<span style="color: #008080;">Statystyki</span>**: ta sekcja przedstawia częstotliwość nazwisk, miejsc i dni roku, od najczęstszych do najrzadszych.

**<span style="color: #008080;">Stopień pokrewieństwa</span>**: ta sekcja przedstawia współczynnik pokrewieństwa wybranego głównego osobnika.

**<span style="color: #008080;">Lista przodków</span>**: ta sekcja przedstawia przodków wybranego głównego osobnika. Przodkowie są wyświetlani w kolejności rosnącej według [numeru Sosa](https://docs.ancestris.org/books/user-guide/page/generate-sosa-numbers#bkmrk-g%C3%A9n%C3%A9ralit%C3%A9s "Generowanie numerów Sosa").

**<span style="color: #008080;">Wyszukiwanie osób</span>**: ta sekcja to narzędzie do wyszukiwania osób w drzewie genealogicznym według zestawu kryteriów.

## <span class="mw-headline">Kreator generowania książki internetowej</span>

Kreator pomaga dostosować strony WebBooka przez 7 paneli. Na końcu pokazuje dziennik generowania.

### Strona powitalna

Ten panel umożliwia dostosowanie strony powitalnej Twojej książki drzewa genealogicznego.

Najedź kursorem na pole, aby zobaczyć podpowiedź wyjaśniającą jego rolę.

[![en-webbook-1.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-1.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-1.png)

- **<span style="color: #008080;">Tytuł książki</span>**: tytuł Twojej książki genealogicznej. Pojawia się na stronie głównej oraz na pasku tytułu przeglądarki.
- **<span style="color: #008080;">Autor</span>**: imię i nazwisko autora Twojej genealogii. 
    - <span style="color: #008080;">Adres</span>: adres autora.
    - <span style="color: #008080;">Numer telefonu i e-mail</span>: dane kontaktowe autora.
- **<span style="color: #008080;">Wiadomość</span>**: zaznacz pole i wpisz wiadomość, która zostanie wyświetlona na początku strony głównej.
- **<span style="color: #008080;">Wyświetl najdłuższą linię przodków</span>**: wyświetla informacje o najdłuższej linii przodków w Twojej genealogii.
- **<span style="color: #008080;">Wyświetl najczęściej występujące miejsce:</span>** wyświetla tę statystykę na stronie głównej.

<p class="callout info">Przy pierwszym otwarciu tego okna dla genealogii, Ancestris wypełni pola informacjami pochodzącymi od osoby DeCujus, jeśli zostały one zdefiniowane.</p>

### Osoby  


[![en-webbook-2.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-2.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-2.png)

- **<span style="color: #008080;">Osoba De-cujus</span>**: główna osoba, do której można dotrzeć ze strony głównej, i od której budowana będzie najdłuższa linia przodków oraz raport przodków.
- <span style="color: #008080;">**Nieznane osoby**</span>: służy do oznaczania osoby, której imię i nazwisko są nieznane (na przykład można wpisać słowo "nieznany" w tym polu).
- **<span style="color: #008080;">Wyświetl:</span>** informacje do wyświetlenia w sekcjach szczegółów osób**<span style="color: #008080;">  
    </span>**
    - <span style="color: #008080;">Małżonkowie</span>: wyświetla informacje o małżonkach
    - <span style="color: #008080;">Dzieci</span>: wyświetla dzieci pod informacjami o rodzinie
    - <span style="color: #008080;">Przyrodni bracia i siostry</span>: wyświetla przyrodnich braci i siostry. Są one określane jako rodzeństwo uterine lub konsangwiniczne.
    - <span style="color: #008080;">Powiązania</span>: wyświetla relacje osoby (świadkowie wydarzeń, rodzice chrzestni itd.)
    - <span style="color: #008080;">Notatki</span>: dodaje notatki powiązane z osobami i rodzinami.
    - <span style="color: #008080;">Numery identyfikacyjne</span>: dodaje numery ID Ancestris po imieniu osoby.
    - <span style="color: #008080;">Przycisk do wysłania maila do autora</span>: wyświetla ikonę "wyślij e-mail" w każdej sekcji osoby, aby odwiedzający mógł łatwo wysłać e-mail do autora dotyczący tej osoby.
- <span style="color: #008080;">**Dane prywatne**</span>: 
    - <span style="color: #008080;">Ukryj dane prywatne</span>: ukrywa dane zdefiniowane w [preferencjach prywatności](https://docs.ancestris.org/books/user-guide/page/preferences#bkmrk-onglet-donn%C3%A9es-priv%C3%A9 "Preferencje").
    - <span style="color: #008080;">Preferencje</span>: przenosi do preferencji prywatności, aby w razie potrzeby je zmienić dla książki internetowej  
        
        - Na stronie PHP dane prywatne będą wygenerowane, ale ukryte; na stronie musi istnieć funkcja php do obsługi profilu.
        - Na stronie html dane są statyczne i informacje prywatne w ogóle nie będą generowane.

### Multimedia

[![en-webbook-3.png](https://docs.ancestris.org/uploads/images/gallery/2020-10/scaled-1680-/en-webbook-3.png)](https://docs.ancestris.org/uploads/images/gallery/2020-10/en-webbook-3.png)

- <span style="color: #008080;">**Źródła**</span>
    - <span style="color: #008080;">Tworzenie sekcji źródeł</span>: dodaje sekcję dostępu do źródeł.
    - <span style="color: #008080;">Menu rozwijane</span>: wybierz, jak chcesz wyświetlać źródła: tylko z informacjami o osobie, z tekstem źródła i z multimediami.
    - <span style="color: #008080;">Lokalna kopia oryginalnych źródeł</span>: kopiuje oryginalne dokumenty do katalogu docelowego (lokalnego lub na stronie internetowej). W przeciwnym razie używane są linki do plików. Zaleca się, aby nie wybierać tej opcji, jeśli łączny rozmiar dokumentów jest duży. Jeśli później chcesz mieć te dokumenty na swojej stronie, zawsze możesz zamienić linki na pliki o mniejszym rozmiarze, używając funkcji kopiowania w swoim systemie.
- <span style="color: #008080;">**Multimedia**</span>
    - <span style="color: #008080;">Tworzenie sekcji mediów</span>: dodaje sekcję dostępu do mediów.
    - <span style="color: #008080;">Lokalna kopia oryginalnych mediów</span>: kopiuje oryginalne pliki multimedialne do katalogu docelowego (lokalnego lub na stronie internetowej).   
        W przeciwnym razie używane są linki do plików. Ta opcja jest podobna do opisanej wyżej opcji źródeł.
- <span style="color: #008080;">**Mapa**</span>
    - <span style="color: #008080;">Tworzenie mapy geograficznej</span>: dodaje sekcję wyświetlającą mapę wydarzeń.
    - <span style="color: #008080;">Wyświetl nieznalezione miejsca</span>: wyświetla znaczniki dla miast, których współrzędne nie zostały znalezione. Znaczniki pojawią się na środku Oceanu Atlantyckiego.

### Raport wstępujący

[![en-webbook-4.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-4.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-4.png)

- **<span style="color: #008080;">Generowanie listy przodków</span>**: dodaje raport przodków, używając osoby De-cujus jako korzenia. W tym przypadku przy generowaniu tej sekcji zostaniesz poproszony o następujące opcje: 
    - <span style="color: #008080;">Pierwsza generacja do wyświetlenia</span>: numer generacji, od której rozpocznie się lista przodków.
    - <span style="color: #008080;">Ostatnia generacja do wyświetlenia</span>: numer generacji, na której lista przodków się zakończy.
    - <span style="color: #008080;">Wyświetl źródła</span>: wybierz, czy i jak wyświetlać źródła w raporcie przodków.

### Lokalna kopia

[![en-webbook-5.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-5.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-5.png)

- **<span style="color: #008080;">Zapisz WebBook lokalnie</span>**: określ katalog, w którym będzie się znajdować WebBook na Twoim dysku. To ten katalog będziesz przeglądać lokalnie za pomocą przeglądarki internetowej, jeśli nie chcesz mieć genealogii w Internecie. Jeśli chcesz przesłać go na stronę internetową, zawartość tego katalogu zostanie przesłana. Jest to opcja na następnym panelu.

<p class="callout danger">Uwaga! Ten katalog musi być pusty, w przeciwnym razie zawarte w nim dokumenty zostaną usunięte.</p>

- **<span style="color: #008080;">Zapisz plik dziennika transferu WebBooka</span>**: wskaż katalog, w którym będzie się znajdował raport dziennika tworzenia WebBooka. Będzie zawierał krok po kroku proces tworzenia i ewentualne błędy.

### Transfer - opcjonalnie

[ ![en-webbook-6.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-6.png) ](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-6.png)

<p class="callout info">Jeśli chcesz tylko wygenerować strony lokalnie, odznacz pierwsze pole wyboru i po prostu kliknij **Dalej**.</p>

- **<span style="color: #008080;">Prześlij strony internetowe na witrynę</span>**: przesyła strony, które zostały zapisane lokalnie, na wybraną przez Ciebie witrynę internetową. Będziesz musiał podać dodatkowe informacje, aby umożliwić przesyłanie. Oto dostępne opcje. Jeśli zdecydujesz się przesłać strony na witrynę, raport poprosi Cię o podanie nazwy pliku dziennika. Ten plik będzie zawierał pełną listę przesłanych plików.
- **<span style="color: #008080;">Adres FTP witryny</span>**: adres Twojej witryny FTP. Przykład: ftp.mojastrona.mojedostawca.pl
- **<span style="color: #008080;">Katalog główny</span>**: docelowy katalog, do którego strony mają być przesłane. Przykład: /home/
- **<span style="color: #008080;">Nazwa użytkownika FTP</span>**: login używany do dostępu do witryny FTP.
- **<span style="color: #008080;">Hasło FTP</span>**: hasło do dostępu do witryny FTP.
- **<span style="color: #008080;">Opis witryny</span>**: zdanie, które wpiszesz tutaj, pojawi się w nagłówkach utworzonych stron HTML jako "meta name - Description". Ten element jest ważny, ponieważ roboty i wyszukiwarki używają go do indeksowania Twoich stron.
- **<span style="color: #008080;">Typ transferu</span>**: pozwala poprawić czas przesyłania. Na przykład, jeśli zdjęcie przodka jest generowane w WebBooku, ale jest identyczne z wcześniej przesłanym, nie ma potrzeby przesyłać go ponownie. 
    - <span style="color: #008080;">Menu rozwijane</span>: dostępne są trzy opcje: przesyłaj wszystkie lokalnie wygenerowane pliki na serwer, nawet jeśli się nie zmieniły; przesyłaj tylko te, które się zmieniły; lub przesyłaj te, które się zmieniły i jednocześnie usuwaj z serwera pliki, które nie są już generowane.
    - <span style="color: #008080;">Resetuj historię transferu</span>: rozpocznij przesyłanie plików od nowa. Oznacza to, że wszystkie pliki zostaną systematycznie przesłane przy następnym transferze. Rejestr zachowuje szczegóły poprzednich przesłań, co pozwala określić, które z nowo wygenerowanych plików trzeba przesłać ponownie. Jeśli używasz WebBooka wyłącznie do przesyłania stron, nie powinno być potrzeby resetowania rejestru. Jednak jeśli czasem korzystasz z innego klienta FTP, rejestr ten może wymagać całkowitego odświeżenia, co następuje po zaznaczeniu tej opcji.
- **<span style="color: #008080;">Program do uruchomienia po generowaniu</span>**: nazwa programu wykonywalnego do uruchomienia po zakończeniu tworzenia WebBooka. Jeśli pierwszy znak to '0', opcja ta jest ignorowana. Uruchamianie programu na końcu może być przydatne, jeśli na Twojej stronie są jeszcze inne zadania do wykonania, aby zakończyć aktualizację.
- **<span style="color: #008080;">Zapisz plik dziennika transferu</span>**: katalog, w którym zostanie zapisany raport dziennika przesyłania. Raport ten pokazuje wyniki przesłanych stron.

### Integracja z witryną PHP – opcjonalnie

[ ![en-webbook-7.png](https://docs.ancestris.org/uploads/images/gallery/2020-10/scaled-1680-/en-webbook-7.png) ](https://docs.ancestris.org/uploads/images/gallery/2020-10/en-webbook-7.png)

<p class="callout info">Jeśli chcesz tylko wygenerować strony lokalnie, odznacz pierwsze pole wyboru i po prostu kliknij **Zakończ**.</p>

Ta część jest techniczna i wymaga znajomości zasad działania witryny PHP, w tym bardzo precyzyjnych struktur stron.

- **<span style="color: #008080;">Witryna PHP</span>**: jeśli chcesz skorzystać z faktu, że Twoja witryna jest napisana w PHP
- <span style="color: #008080;">**Kody:**</span> nazwa użytkownika i hasło używane do przeglądania prywatnych informacji.
- **<span style="color: #008080;">Istniejąca witryna</span>**: zaznacz to pole, jeśli strony genealogiczne są zintegrowane z większą witryną i muszą wtedy respektować te same nagłówki i stopki na przykład
- **<span style="color: #008080;">Dane prywatne</span>**: podaj tutaj nazwę funkcji PHP, która będzie weryfikować kody dla danych prywatnych.
- **<span style="color: #008080;">Skrypty</span>**: podaj tutaj skrypty PHP odpowiadające różnym komponentom Twojej witryny PHP.

### Wynik tworzenia stron

Ancestris wyświetla [okno wyjścia](https://docs.ancestris.org/books/user-guide/page/window-menu#bkmrk-sortie "Okno Menu") na końcu procesu. Zobaczysz dwa logi: tworzenia stron oraz przesyłania stron, jeśli poprosiłeś o upload.

Oto przykład pomyślnego tworzenia stron.

[ ![en-webbook-log.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-log.png) ](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-log.png)

### Wynik przesyłania

Oto przykład nieudanego przesłania.

[ ![en-webbook-log-failed.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/en-webbook-log-failed.png) ](https://docs.ancestris.org/uploads/images/gallery/2020-09/en-webbook-log-failed.png)

### Dodatkowe informacje

- Informacje prywatne są zarządzane za pomocą opcji Ancestris. Jeśli osoba jest uznana za prywatną zgodnie z opcjami Ancestris, WebBook wyświetli "..." zamiast zwykłych danych tekstowych.
- Numeracja Sosa jest uwzględniana, jeśli etykiety "\_SOSA" lub "\_SOSADABOVILLE" zostały wygenerowane. Sprawdź [dokumentację Generowanie numerów Sosa](https://docs.ancestris.org/books/user-guide/page/generate-sosa-numbers "Generowanie numerów Sosa"). Upewnij się, że w takim przypadku główny DeCujus zdefiniowany na początku WebBooka jest taki sam jak dla numerów Sosa.
- Jeśli lokalny katalog, w którym strony mają być zapisane, nie jest pusty, pojawi się stosowny komunikat.
- Wygenerowane strony HTML są certyfikowane jako W3C XHTML 1.0.
- Znaki specjalne są w stronach zamieniane na odpowiednie sekwencje HTML (np. "é" jest zamieniane na "&amp;eacute;").
- Aby zoptymalizować wydajność, pliki multimedialne i źródłowe nie są kopiowane (lub linkowane), jeśli już istnieją w katalogu docelowym. Aby wymusić kopiowanie (lub linkowanie), wystarczy usunąć pliki w katalogu docelowym.
- Funkcja ułatwia użytkownikowi strony internetowej wysyłanie maili do autora.
- Funkcja oszczędza znaczny czas, przesyłając tylko pliki, których zawartość uległa zmianie. Działa to bardzo dobrze, jeśli WebBook jest jedynym programem używanym do przesyłania stron, ponieważ przechowuje szczegóły przesłanych plików z każdego transferu.