Parsoid/Setup/pl

Zanim zaczniesz
Jeśli używasz Parsoid w połączeniu z VisualEditor, zauważ, że są one rozwijane równolegle i uaktualnienia do jednego często wymagają odpowiedniego uaktualnienia do drugiego. W razie wątpliwości sprawdź Extension:VisualEditor/pl stronę i postępuj zgodnie z instrukcjami konfiguracyjnymi.

Oczywiście Parsoid może być używany samodzielnie (do przekonwertowania wikitext na HTML DOM i na odwrót) a jeśli nie potrzebujesz programu VisualEditor, możesz zignorować powyższe.

Jeśli jesteś programistą lub nie masz dostępu do sudo apt-get, ponieważ jesteś na współdzielonym hostingu, prawdopodobnie zechcesz śledzić instrukcje Developer Setup. Ta strona dokumentuje konfigurację typowego użytkownika Parsoid przy użyciu rodzimego oprogramowania dla twojego systemu operacyjnego. (Chociaż, jeśli preferowany system operacyjny nie jest tutaj wymieniony, możesz wypróbować instrukcje instalatora &mdash; powodzenia!)

Jeśli udostępniany hosting nie pozwala zainstalować Parsoid, możesz również wypróbować to obejście:Installation on a shared host.

Jeśli napotkasz problemy, skonsultuj się ze stronami troubleshooting. Jeśli chcesz wesprzeć swoje problemy i zaproponować rozwiązania innym, zachęcamy do dodania tych informacji do stron rozwiązywania problemów, aby zachować tę stronę typowych instrukcji instalacyjnych w sposób możliwie jasny i prosty.

Najpierw musisz zainstalować Parsoid. Po wykonaniu tej czynności przejdź do opcji ,sekcji tej strony, aby upewnić się, że Parsoid może komunikować się z instancją mediawiki.

Ubuntu / Debian
Pakiety te działają na wszystkich architekturach i przy aktualnych dystrybucjach: Ubuntu 14+ i Debian testowanie, niestabilne lub wheezy (stable) z backportami. Zobacz instrukcje manual installation on Linux or Mac OS X jeśli twoja dystrybucja jest starsza i nie ma nodejs >= v4.x dostępny.

Zaimportuj repozytorium klucza gpg: (klucz zaktualizowany w lipcu 27, 2016)

Jeśli ostatnie polecenie powyżej nie jest aktualizowane w trybie roboczym w lipcu (gpgkeys: klucza 90E9F83F22250DD7 nie można odzyskać), możesz wypróbować inny kluczowy serwer. Ten powinien działać:

Dodaj repozytorium Wikimedia: Na Ubuntu 16.04 może być konieczne zainstalowanie "software-properties-common" w celu uruchomienia "apt-add-repository" apt-get install software-properties-common
 * Ubuntu

Zainstaluj:
 * Debian

Następnie otwórz plik konfiguracyjny in  i zaktualizuj go, aby odzwierciedlić adres URL interfejsu API. Zobacz sekcję poniżej, aby uzyskać szczegółowe informacje.

Uwagi: Zastrzeżenia dotyczące deb: Błąd ładowania danych z serwera/Error loading data from server: internal_api_error_Exception: [0db2f13b5ceecfae5a4c1a98] Exception caught: PHP cURL extension missing. Check https://www.mediawiki.org/wiki/Manual:CURL. Would you like to retry? rozwiązany przy pomocy apt install php-curl systemctl reload apache2 PS: po wysłaniu tego zauważyłem https://www.mediawiki.org/wiki/Extension:VisualEditor#Troubleshooting wspomina podobnie.
 * Modyfikacje wprowadzone do pliku konfiguracyjnego staną się aktywne dopiero po ponownym uruchomieniu usługi.
 * Repozytorium będzie zawierało najnowszą dostępną wersję Parsoid. Older versions można zainstalować ręcznie.
 * Domyślny port to 8142 (nie 8000 więc musisz na przykład zmienić  w LocalSettings.php).
 * Plik dziennika to, i jest automatycznie obracany (?).
 * Jeśli masz starszą dystrybucję i nodejs >= v4 jest niedostępny, zobacz the Nodejs installation instructions. Być może uda Ci się uzyskać najnowszą wersję pakietu nodejs. Jeśli musisz zainstalować node.js ze źródła (zalecamy nave), musisz użyć instrukcji Parsoid/Developer Setup.
 * Niektórzy użytkownicy zgłaszają, że powinieneś również upewnić się, że curl jest również zainstalowany: . Podaj więcej szczegółów tutaj, jeśli uważasz, że tak jest w twojej konfiguracji.
 * 2018-09-20 podczas naszego uaktualnienia z mw v29 do 31, mamy już zainstalowane curl. Kiedy testowałem VE dostałem to:

Arch
Parsoid jest dostępny w AUR pod aur/parsoid (release version) lub aur/parsoid-git (development version). Zainstaluj jednak pakiety AUR. Włącz i uruchom usługę Parsoid i skonfiguruj jak poniżej. Pamiętaj, aby ponownie uruchomić usługę, aby zmiany zaczęły obowiązywać.

To instaluje się domyślnie do.

RedHat/CentOS
Parsoid jest dostępny z repozytorium Git.

Spróbuj utworzyć pusty katalog i sprawdź kopię Parsoid:

To powinno wrzucić wszystko, co potrzebujesz, do bieżącego katalogu. Skopiuj domyślną konfigurację (który konfiguruje serwer Parsoid do nasłuchu http://localhost:8000 ):

Edytuj ten plik za (poniżej), następnie uruchom serwer za pomocą:

W tym momencie, otwierając przeglądarkę na localhost:8000 powinien wyświetlić stronę z linkami do dokumentacji Parsoid na stronie www.mediawiki.org

Jako ostatni krok zmień swoje pliki startowe (init.d) aby dodać zadanie do ponownego uruchomienia  przy starcie serwera.

Vagrant
Jeśli używasz wirtualną maszynę MediaWiki-Vagrant, rola  ustawia działający Parsoid. Jeśli używasz rolę, Umożliwi to również wykorzystanie parosoidów.

Windows
Wymagania: Z nodejs musisz zainstalować narzędzia do budowania (jako administrator) npm install --global --production windows-build-tools
 * Zainstaluj Nodejs x86
 * Zainstaluj Git x86

Być może będziesz musiał zaktualizować swoją wersję npm, aby uniknąć błędów.

npm -g install npm@latest

jeśli npm @ dalej jest zepsuty. Zobacz https://github.com/npm/npm/issues/16037

Jeśli twój aktualny katalog jest w C:\windows\system32, Wykonaj następujące polecenie

cd %USERPROFILE%

Zainstaluj Parsoida npm install parsoid Uwaga: jeśli otrzymasz komunikat o błędzie 'nie ma takiego pliku lub katalogu 'c:\user\{username}\package.json' uruchom następujące:

npm init Skopiuj domyślną konfigurację i skonfiguruj funkcję parsoid dla Windows Vista/7

copy %USERPROFILE%\node_modules\parsoid\localsettings.example.js %USERPROFILE%\node_modules\parsoid\localsettings.js

lub dla Windows 8+

copy %APPDATA%\npm\node_modules\parsoid\localsettings.example.js %APPDATA%\npm\node_modules\parsoid\localsettings.js

Uruchom Parsoida lub w Windows 10+

cd %APPDATA%\npm\node_modules\parsoid node bin/server.js Powinieneś otworzyć swój plik php.ini i odkomentuj następne moduły php: inaczej będziesz mieć kłopoty z Parsoidem
 * extension=php_curl.dll
 * extension=php_openssl.dll

Docker
To jest wersja Parsoida stworzona przez społeczność. Oryginalne repozytorium można znaleźć pod adresem TheNets's GitHub.

Dostępne są dwie wersje: 0.8.1 and 0.9.0.

Obrazy zostały utworzone ponad Alpine image.

Wymagania

 * Docker installed

Jak uruchomić
Aby uruchomić Parsoid uruchom poniższe polecenie. Zwróć uwagę na wersję MediaWiki i wybierz kompatybilną wersję Parsoid.

Przykłady
Aby dodać więcej niż jedną domenę: Jak odsłonić na określonym porcie: (Możesz użyć dowolnych numerów portów, które nie są jeszcze używane) Aby uzyskać więcej informacji o konfiguracji Docker, sprawdź GitHub page.

Konfiguracja
Począwszy od Parsoid 0.6.0, plik konfiguracyjny znajduje się tutaj:

Jeżeli plik  Twojej wiki nie jest domyślny, tj. edytuj plik  i zmodyfikuj parametr   wskazujący poprawną lokalizację:

Właściwość  podaje ścieżkę API do lokalnej wiki. Właściwość  jest opcjonalna; domyślnie jest to nazwa hosta używana we właściwości , jeśli nie jest jawnie ustawiona, ale może to być dowolny ciąg znaków (nie musi on być rozpoznawany w DNS).

Jeśli twoja wiki znajduje się w odwrotnej konfiguracji proxy lub podobnej, możesz ustawić nazwę hosta w  do wewnętrznej nazwy hosta lub adresu IP, który wskazuje na wewnętrzny adres IP Twojej wiki, aby uniknąć wysyłania żądań do publicznego adresu IP, a następnie kierować z powrotem na serwer wewnętrzny. Upewnij się jednak, że twój serwer sieciowy faktycznie kieruje żądania z tą nazwą hosta do wiki (jeśli serwer jest skonfigurowany do obsługi różnych rzeczy dla wielu witryn lub subdomen).

Na przykład: masz wiki na stronie  z publicznym adresem IP za serwerem proxy, a aktualny serwer aplikacji znajduje się na drugim wewnętrznym serwerze, który obsługuje tylko żądania do nazwy host wiki, , ale nie z innymi nazwami hosta (ponieważ służy różnym stronom internetowym). Może być konieczne ustawienie na  aliasa z   i skonfiguruj swój serwer sieciowy   jako alias do. Następnie możesz użyć tej nazwy hosta we właściwościach uri.

Domyślnie Parsoid otwiera gniazdo UDP i wysyła co minutę kilka metryk dotyczących stosu Parsoid do serwera statsD. Jeśli chcesz wysłać te dane do zaplecza rejestrowania (z poziomem dziennika "trace"), dodaj w :

localsettings.js (lub settings.js) jako plik konfiguracyjny
Jeśli wolisz używać  jako twój plik konfiguracyjny, to w pliku   odkomentuj ścieżkę/path   taka jak ta: i komentarz,   i   parametry takie jak to:

W tym podejściu plik konfiguracyjny znajduje się w jednej z następujących lokalizacji:
 * (jeśli zainstalowałeś z naszych pakietów Linux)
 * (jeśli podążałeś za instrukcją developer setup)

Jedyną wymaganą zmianą jest aktualizacja jej w celu odzwierciedlenia adresu URL interfejsu API, na przykład:

to arbitralnie wybrany krótki ciąg znaków identyfikujący lokalne wiki, używany w komunikatach dziennika. jest również opcjonalnym, arbitralnym unikalnym łańcuchem, który zostanie wygenerowany, jeśli zostanie pominięty. Upewnij się, że konfiguracja VisualEditor używa tej samej wartości "domain" i/lub "prefixu" jak Parsoid. (Zobacz Instrukcje konfiguracji VisualEditor.)

Gdy wiele wiki ma tę samą usługę parsoid
Jeśli masz wiele wiki, upewnij się, że  łańcuch/string (i/lub , jeśli używasz   jako plik konfiguracyjny) jest unikalny dla każdego. Wielokrotne wiki udostępniające jednego hosta może wymagać jawnego ustawienia właściwości  do dowolnego unikalnego łańcucha dla każdej wiki.

Przykład konfiguracji w  dla wielu wiki:

Przykład konfiguracji w  dla wielu wiki:

Zobacz Parsoid/Troubleshooting aby uzyskać dodatkową pomoc w rozwiązywaniu problemów.

Zobacz Parsoid/Setup/RESTBase aby uzyskać informacje na temat konfigurowania lokalnej instancji RESTBase między lokalnym programem VisualEditor i lokalnym Parsoid.

Parsoid/Setup/RESTBase/Arbitrary domains strona opisuje zaawansowaną konfigurację RESTBase, ale może oferować dodatkowe informacje na temat celu  i właściwości.