InterWiki: historyczna wersja

To jest najnowsza wersja strony z , edytowana przez użytkownika 🍬.

Podgląd

To jest dokumentacja pliku https://wandystan.eu/varia/intermap.txt

Spis treści

Co to jest InterWiki?

InterWiki to sposób tworzenia odnośników do stron znajdujących się na innych witrynach wiki przy użyciu krótkiego wyróżnika danej witryny. Przykładowo, stosując składnię taką jak [[Example:Tytuł strony]] (MediaWiki, PmWiki), [[Example>Tytuł strony]] (System Stron Wandejskich, DokuWiki), czy Example:"Tytuł strony" (UseModWiki), możemy utworzyć odnośnik do strony znajdującej się pod adresem https://example.org/wiki/Tytuł_strony.

Główną zaletą takiego sposobu tworzenia odnośników jest to, że jeżeli adres witryny do której utworzono odnośnik zmieni się, niepotrzebne jest uaktualnianie odnośników na każdej stronie.

Niniejsza strona używa szeroko odnośników InterWiki w celach poglądowych. Są one (tylko na tej stronie) oznaczone poprzedzającą gwiazdką (*).

Czym jest plik intermap.txt?

Jest to plik, w którym zawarte są wyróżniki mikronacyjnych witryn wiki (ale nie tylko), wraz z przedrostkami oraz przyrostkami dołączanymi do tytułu strony, aby uzyskać jej adres internetowy.

Składa się on z oddzielonych znakami nowej linii wpisów, składających się z oddzielonych znakiem przerwy kolejno:

  1. Wyróżnika witryny, zaczynającego się wielką literą i zawierającego jedynie znaki pisma łacińskiego bez znaków diakrytycznych oraz kropki;
  2. Przedrostka adresu strony internetowej;
  3. (nieobowiązkowo) Przyrostka adresu strony internetowej.

Dodatkowo, w pierwszej linii zawsze zamieszczony jest adres niniejszej strony z opisem tego pliku. Linia ta jako jedyna zawsze zaczyna się kropką.

Format pliku jest zgodny z formatem InterMap używanym m. in. przez UseModWiki.

Jak używać pliku intermap.txt?

Należy ustawić okresowe wykonywanie skryptu (np. za pomocą crona, czasomierzy systemd), który:

  1. Pobiera plik intermap.txt z https://wandystan.eu/varia/intermap.txt;
  2. Przetwarza go na format właściwy dla zainstalowanego systemu wiki (bądź wstawia dane w nim zawarte do bazy danych);
  3. Zapisuje go we właściwym miejscu.

Przykład takiego skryptu można znaleźć poniżej:

#! /bin/sh
#
# Any copyright is dedicated to the Public Domain.
# http://creativecommons.org/publicdomain/zero/1.0/
#
target=/path/to/the/wiki/installation/localmap.txt
trap 'rm -f "$target.tmp"' EXIT

test "$(
    exec 3>&1
    {
        curl -fsS https://wandystan.eu/varia/intermap.txt
        echo $? >&3
    } | tail -n +2 | while IFS=' ' read -r moniker prefix suffix
    do
        # Change the line below to fit your wiki system
        printf '%s: %s$1%s\n' "$moniker" "$prefix" "$suffix"
    done > "$target.tmp"
)" -eq 0 || exit 1
mv -f "$target.tmp" "$target"

Innym przykładem takiego skryptu jest intermap2php, używany przez System Stron Wandejskich i wywoływany za pomocą następującej reguły make:

include.interwiki.php: ../varia/intermap.txt helpers/intermap2php
    helpers/intermap2php < $< > $@

Po co to wszystko?

Natchnieniem do stworzenia ujednoliconego wykazu wyróżników InterWiki były wielokrotnie podnoszone pomysły utworzenia nowej mikroświatowej encyklopedii oraz biblioteki. Jednocześnie, wiele krajów posiada już swoje własne encyklopedie i biblioteki, których raczej nie będą chciały się pozbyć. W niektórych krajach podejmowane są także działania mające w zamiarze utworzenie nowych tego rodzaju zbiorów, jak np. Nowa Biblioteka im. św. Róży. Dlatego też przydatna byłaby możliwość łatwego tworzenia odnośników pomiędzy stronami znajdującymi się w różnych zbiorach.

Dzięki odnośnikom InterWiki, strona o Dreamlandzie w Encyklopedii Wandejskiej, zamiast posiadać dziesiątki czerwonych odnośników do stron, które raczej szybko tam nie powstaną, mogłaby linkować do odpowiednich stron w encyklopedii dreamlandzkiej. Także w drugą stronę: encyklopedia dreamlandzka, zamiast opisywać rzeczy już opisane w Encyklopedii Wandejskiej, mogłaby jedynie odnosić się do stron w niej zawartych.

Osądy na ten temat wyrażane przez Wandejczyków są przychylne:

No to jest mega (…) zajebiste. Przyznam że sporo bym dał za taką metodę jak bawiłem się w v-encyklopedie (łącznie że trzy czy cztery nie licząc Wandejskiej) i zawsze potykałem się o problem uzupełniania danych z i o innych krajach.

— Prezerwatyw Tradycja Radziecki, wiadomość nr 53697

[J]ak wyobrażam sobie realnie interlinkująca sieć wiedzy mikronacyjnej, to autentycznie my pee-pee hard.

— Alojzy Pupka, wiadomość nr 53714