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 mentions similar.
 * 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 is available in AUR under aur/parsoid (release version) or aur/parsoid-git (development version). Install however you would usually install AUR packages. Enable and start the parsoid service and configure per below. Remember to restart the service for changes to take effect.

This installs to  by default.

RedHat/CentOS
Parsoid is available from the Git repository.

Try creating an empty directory and checking out a copy of Parsoid:

This should dump everything you need into the current directory. Copy the default configuration (which configures the Parsoid server to listen at http://localhost:8000 ):

Edit this file per (below), then start the server with:

At this point, opening a browser to localhost:8000 should display a page with links to the Parsoid documentation on www.mediawiki.org

As one final step, change your startup files (init.d) to add a task to relaunch  on server startup.

Vagrant
If you are using the MediaWiki-Vagrant virtual machine, the  role sets up a working Parsoid. If you use the  role, it will enable parsoid as well.

Windows
Requirements: With nodejs you have to install the build tools (as administrator) npm install --global --production windows-build-tools
 * Install Nodejs x86
 * Install Git x86

You may need to update your npm version to avoid errors

npm -g install npm@latest

npm@next is broken. See https://github.com/npm/npm/issues/16037

If your current directory is in C:\windows\system32, Perform the following command

cd %USERPROFILE%

Install parsoid npm install parsoid Note: if you get errors 'no such file or directory on 'c:\user\{username}\package.json' run the following:

npm init Copy the default config and configure parsoid for Windows Vista/7

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

or for Windows 8+

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

Run parsoid or on Windows 10+

cd %APPDATA%\npm\node_modules\parsoid node bin/server.js You should open your php.ini file and uncomment the next php modules: otherwise you will get troubles with Parsoid
 * extension=php_curl.dll
 * extension=php_openssl.dll

Docker
This is a version of Parsoid created by community. The original repository can be found at TheNets's GitHub.

Two versions are available: 0.8.1 and 0.9.0.

The images was created over Alpine image.

Requirements

 * Docker installed

How to run
To start Parsoid run the command below. Just pay attention to the MediaWiki version and choose a compatible Parsoid version.

Examples
How to add more than one domain: How to expose on a specific port: (You can use arbitrary port numbers which are not already in use) For more information about Docker setup, check the 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.