InterWiki: historyczna wersja − Wschodni Klub Techniki i Racjonalizacji

InterWiki: historyczna wersja

To jest stara wersja strony z 13 lutego 2020, 14:38:27, edytowana przez użytkownika 🍬. Może się ona różnić od obecnej wersji.

*To jest dokumentacja pliku <https://wandystan.eu/varia/intermap.txt>* ### Co to jest InterWiki? [[MeatBall>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 [[MeatBall>InterMap]] używanym m. in. przez [[UseMod>UseModWiki]]. ### Jak używać pliku `intermap.txt`? Należy ustawić cykliczne wykonywanie skryptu (np. za pomocą [[Wikipedia>cron|crona]], czasomierzy [[Wikipedia>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: ``` sh #! /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`](/varia/intermap2php) używany przez System Stron Wandejskich i wywoływany za pomocą następującej reguły `make`: ``` make include.interwiki.php: ../varia/intermap.txt helpers/intermap2php helpers/intermap2php < $< > $@ ``` ### Po co to wszystko? Cytując [[LDMW>53696|post tow. Polyny na LDMW]]: > Inspiracją do zrobienia tego były plany kooperacji na froncie biblioteczno-encyklopedycznym w ramach tzw. Ligi Bluszczowej (ugh) <http://spolecznosc.bialenia.org.pl/showthread.php?tid=1235&pid=10423#pid10423>. Ostatnie działania w bratnim Królestwie Dreamlandu <https://forum.dreamland.net.pl/viewtopic.php?f=583&t=11205> sugerują, że będzie ona zmierzała raczej w kierunku decentralistycznym, więc uważam, że łatwe linkowanie pomiędzy bibliotekami/encyklopediami jest konieczne. > > Liczę na to, że dzięki temu np. strona w Encyklopedii Wandejskiej o Dreamlandzie <https://wandystan.eu/w/Encyklopedia::Dreamland>, zamiast posiadać dziesiątki czerwonych linków do artykułów, które raczej u nas szybko nie powstaną, będzie mogła linkować po prostu do encyklopedii dreamlandzkiej. > > I oczywiście także w drugą stronę: encyklopedia dreamlandzka, zamiast duplikować tematy już zawarte w Encyklopedii Wandejskiej, będzie po prostu posiadała linki do stron Wandystanu. Dlatego też Komisariat Ludowy do spraw Informatycznych pracuje obecnie nad udostępnieniem ujednoliconej bazy prefiksów interwiki, z którą inne mikronacje będą mogły po prostu się synchronizować. Mam nadzieję, że z tego skorzystają.

Podgląd

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

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:

Wyróżnika strony, zaczynającego się wielką literą i zawierającego jedynie bezdiakrytyczne znaki alfabetu łacińskiego oraz kropki;
Prefiksu adresu strony internetowej;
(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:

Pobiera plik intermap.txt z https://wandystan.eu/varia/intermap.txt;
Konwertuje go na format właściwy dla zainstalowanego systemu wiki (alternatywnie: wstawia dane w nim zawarte do bazy danych);
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?

Cytując post tow. Polyny na LDMW:

Inspiracją do zrobienia tego były plany kooperacji na froncie biblioteczno-encyklopedycznym w ramach tzw. Ligi Bluszczowej (ugh) http://spolecznosc.bialenia.org.pl/showthread.php?tid=1235&pid=10423#pid10423. Ostatnie działania w bratnim Królestwie Dreamlandu https://forum.dreamland.net.pl/viewtopic.php?f=583&t=11205 sugerują, że będzie ona zmierzała raczej w kierunku decentralistycznym, więc uważam, że łatwe linkowanie pomiędzy bibliotekami/encyklopediami jest konieczne.

Liczę na to, że dzięki temu np. strona w Encyklopedii Wandejskiej o Dreamlandzie https://wandystan.eu/w/Encyklopedia::Dreamland, zamiast posiadać dziesiątki czerwonych linków do artykułów, które raczej u nas szybko nie powstaną, będzie mogła linkować po prostu do encyklopedii dreamlandzkiej.

I oczywiście także w drugą stronę: encyklopedia dreamlandzka, zamiast duplikować tematy już zawarte w Encyklopedii Wandejskiej, będzie po prostu posiadała linki do stron Wandystanu. Dlatego też Komisariat Ludowy do spraw Informatycznych pracuje obecnie nad udostępnieniem ujednoliconej bazy prefiksów interwiki, z którą inne mikronacje będą mogły po prostu się synchronizować. Mam nadzieję, że z tego skorzystają.