InterWiki: historyczna wersja

To jest stara wersja strony z , edytowana przez użytkownika 🍬. Może się ona różnić od obecnej wersji.

Podgląd

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

Spis treści

Co to jest InterWiki?

InterWiki to metoda linkowania do artykułów znajdujących się na innych stronach typu wiki przy użyciu krótkiego wyróżnika danego wiki. Przykładowo, używając składni typu [[Example:Tytuł strony]] (MediaWiki, PmWiki), [[Example>Tytuł strony]] (System Stron Wandejskich, DokuWiki), czy Example:"Tytuł strony" (UseModWiki) możemy zalinkować do artykułu znajdującego się pod adresem https://example.org/wiki/Tytuł_strony.

Główną zaletą takiego sposobu linkowania jest to, że jeżeli adres podlinkowanej witryny zmieni się, niepotrzebna jest aktualizacja odnośników na każdej stronie.

Niniejsza strona używa ekstensywnie odnośników InterWiki w celach demonstracyjnych. 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 stron typu wiki (ale nie tylko), wraz z prefiksami oraz sufiksami dołączanymi do tytułu artykułu, aby uzyskać jego adres strony internetowej.

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

  1. Wyróżnika strony, zaczynającego się wielką literą i zawierającego jedynie bezdiakrytyczne znaki alfabetu łacińskiego oraz kropki;
  2. Prefiksu adresu strony internetowej;
  3. (opcjonalnie) Sufiksu adresu strony internetowej.

Dodatkowo, w pierwszej linijce zawsze zamieszczony jest adres niniejszego artykułu dokumentującego ten plik. Linijka 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ć cykliczne wykonywanie skryptu (np. za pomocą crona, czasomierzy systemd), który:

  1. Pobiera plik intermap.txt z https://wandystan.eu/varia/intermap.txt;
  2. Konwertuje go na format właściwy dla zainstalowanego systemu wiki (alternatywnie: wstawia dane w nim zawarte do bazy danych);
  3. Zapisuje go we właściwej lokalizacji.

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?

Inspiracją do stworzenia ujednoliconego wykazu wyróżników InterWiki były wielokrotnie podnoszone pomysły na utworzenie 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 znajdującymi się w takich miejscach stronami.

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

Warto także zacytować opinię tow. Radzieckiego w tej kwestii:

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.