Pomoc:Mechanizm działania eksportera

☚✽☛

Tworzenie e-booka dla potrzeb czytelnika podlega na Wikiźródłach licznym ograniczeniom.

W tym tekście skupiam się na technicznych ograniczeniach, na tworzeniu struktury, tak by na końcu uzyskać funkcjonalny plik generowany przez eksportera.

Eksperymenty z generowaniem e-booków bywają nieco frustrujące:

• nie zawsze e-book jest generowany z najnowszej wersji tekstu
• generowanie e-booka trwa dość długo

Na końcu można znaleźć kilka słów na ten temat.

Rozdziały

W e-booku może być spis treści i rozdziały. Ściśle rzecz biorąc pewna rudymentarna struktura powstaje zawsze, niemniej jednak nie to mam na myśli.

Rozdziały w e-booku pozwalają na nawigację przy pomocy strzałek (czy innych skrótów) od jednego do następnego (lub poprzedniego) rozdziału, generują też spis treści TOC.

Nasz generator e-booków umożliwia tworzenie dwóch poziomów rozdział-podrozdział (nazwa nie ma znaczenia, może to być część-rozdział, tom-księga, akt-scena itp.)

Jeśli mamy więc dwa poziomy uzyskujemy dodatkowo rozwijalny spis treści, co czyni spis treści nieco bardziej przejrzystym.

Tworzenie rozdziałów

Tworzymy najpierw pewną stronę wyjściową (główną, indeksującą). Na niej są odnośniki do innych stron. Będą to rozdziały naszego e-booka, a linkowane strony zostaną włączone do e-booka. Jeśli na tych stronach dalej są odnośniki do innych strony, i te strony mogą zostać włączone jako podrozdziały.

Sposób prezentacji rozdziałów i podrozdziałów zależy od linków, przy czym zachowywany jest sposób prezentacji linku [[ linkowana strona | widoczna jako ]].

A co z summary?

Cóż, to jest aspekt techniczny przy tworzeniu struktury e-booków.
Kiedy jest potrzebne summary?

• gdy na stronie indeksującej (głównej, wyjściowej) linki, które chcemy włączyć, nie są jej podstronami.
  
• na stronie głównej (wyjściowej) gdy chcemy ewentualnie zrobić jakąś bardziej skomplikowaną strukturę (np. strony, które mają być włączone jako rozdziały występują obok linków do stron, które nie mają być włączone) – chodzi o to, że korzystając z {{summary| oraz {{summary|widoczny=nie| można pokryć różne skomplikowane sytuacje. Można też użyć <div class="ws-noexport">
• "piętro niżej", tj. na już włączonej stronie

Jak jest tworzona struktura e-booka?

E-book ze spisem treści rozwijalnym:

Zwinięty spis treści	Rozwinięty spis treści	Rozwinięty spis treści
Wstęp ►Rozdział pierwszy ►Rozdział drugi ►Rozdział trzeci	Wstęp ▼Rozdział pierwszy  Podrozdział I  Podrozdział II  Podrozdział III  Podrozdział IV  Podrozdział V ►Rozdział drugi ►Rozdział trzeci	Wstęp ►Rozdział pierwszy ▼Rozdział drugi  Podrozdział I  Podrozdział II  Podrozdział III  Podrozdział IV  Podrozdział V  Podrozdział VI  Podrozdział VII  Podrozdział VIII  Podrozdział IX ►Rozdział trzeci

E-book ze spisem treści nierozwijalnym:

Wstęp
Rozdział pierwszy
Podrozdział I
Podrozdział II
Podrozdział III
Podrozdział IV
Podrozdział V
Rozdział drugi
Podrozdział I
Podrozdział II
Podrozdział III
Podrozdział IV
Podrozdział V
Podrozdział VI
Podrozdział VII
Podrozdział VIII
Podrozdział IX
Rozdział trzeci
Podrozdział I
Podrozdział II
Podrozdział III

Jak widać, pierwsza wersja wygląda nieco bardziej przejrzyście, ale

• nie w każdej przeglądarce ta struktura jest widoczna
• przy czytaniu tekstu ciągłego (powieści) niewiele zasadniczo rzecz biorąc daje (i tak czytamy po kolei tekst)
• korzystając ze spisu treści utworzonego na stronach e-booka nawigujemy niejako obok tego spisu treści

i co najważniejsze

• przy pomocy ws-exportera możemy zrobić jedynie dwa poziomy (a więc rozdział/podrozdział jak powyżej, przy czym konkretne nazwy część, księga, rozdział, pieśń, akt itp. nie mają znaczenia technicznego)

Jeszcze o summary

W typowym przypadku (tzn. jeśli chcemy wszystkie linkowane strony włączyć do e-booka) na stronie głównej szablon summary jest niepotrzebny, gdy odnośniki prowadzą do podstron danej strony (czyli po nazwa strony głównej/dalszy ciąg nazwy)^[1]. Jest konieczny jednak gdy linkowane strony, które mają być włączone nazywają się inaczej (czyli nie są podstronami strony głównej).

Na drugim poziomie (a więc w rozdziałach), gdy chcemy włączyć podrozdziały summary jest konieczne.

O kolejności włączenia decyduje kolejność wystąpienia na stronie.

by-pass cache

https://ws-export.wmcloud.org/?lang=pl&page=Dzieci%C4%99+Starego+Miasta/ca%C5%82o%C5%9B%C4%87&format=pdf-a5&fonts=&nocache=1

lub odpowiednia opcja na stronie:

https://wsexport.wmflabs.org/tool/book.php?lang=pl&page=Dzieci%C4%99+Starego+Miasta/ca%C5%82o%C5%9B%C4%87&format=pdf-a5&fonts=&credits=false&nocache=1

Nawet to może się okazać niewystarczające, warto zrobić na stronie w przestrzeni głównej purge lub jakąś drobną edycję.

Typy tekstów na Wikiźródłach

Przedstawiono wcześniej klasyfikację tekstów na Wikiźródłach. Podział ten jest jednak do pewnego stopnia akademicki. Istotne jest, by pamiętać o pewnych zasadach i ograniczeniach, wtedy klasyfikacja staje się sprawą wtórną.

1. Nie należy niepotrzebnie nadmiernie rozbudowywać hierarchii, lepiej jest ją uprościć, jeśli nie jest konieczny głęboki podział.
2. Części niesamodzielne tworzymy jako podstrony (czyli po ukośniku)
3. W e-booku mamy do dyspozycji dwa poziomy hierarchii, jeśli potrzebujemy ich więcej, musimy odnośniki do więcej niż jednego poziomu umieścić na głównej lub na stronach rozdziałów

1. Należy zauważyć, że liczba ukośników w nazwie nie jest istotna, włączony zostanie zarówno nazwa strony głównej/jakaś podstrona jak i nazwa strony głównej/coś tam/jeszcze głębiej/następny poziom/strona do włączenia

Części tekstu • Klasyfikacja tekstów ze względu na strukturę • Nawigacja w przeglądarce między częściami tekstu • Samodzielność części tekstu • Mechanizm działania eksportera • Odnośniki wewnętrzne w tekście • Graficzno‑wizualne wyróżnienia części tekstu • Transkluzja przy pomocy tagu pages • Formatowanie bloków tekstu • Metryka dokumentu • Budowa strony w przestrzeni głównej • Strony całości • Tytuły tekstów, nazwy stron • Tworzenie stron powyżej limitu transkluzji