RESTBase/Installation/pl

Pobieranie RESTBase ze źródła
Możesz wykonać tę operację z dowolnego folderu, w którym masz uprawnienia.

Pobierz z git: Możesz też pobrać plik ZIP z repozytorium projektu i wyodrębnić go.

Z katalogu \home\TY\RESTBase\project (np. na UBUNTU), zainstaluj zależności Node przy użyciu npm (część nodejs):

Konfiguracja
Skopiuj przykładową konfigurację:

Edytuj plik config.yaml w tych częściach:


 * Nie musisz niczego zmieniać ani martwić się tą sekcją, chyba że uruchomisz prywatną wiki (zobacz pytania).


 * jest podstawową domeną twojej wiki (lub identyfikator, jeśli masz kilka wiki na różnych ścieżkach tej samej domeny). Na przykład, dla MediaWiki jest to . Jest używany jako ścieżka identyfikatora w przypadku, gdy używasz tego samego serwera dla wielu wiki. For use with Parsoid in MediaWiki 1.35+, the domain must match exactly the host portion of your wiki's   configuration.


 * jest lokalizacją  Twojej wiki. Na przykład, punktem końcowym API MediaWiki jest mediawiki.org/w/api.php. Zobacz.
 * jest punktem końcowym, ponieważ można uzyskać do niego dostęp z Internetu. Jeśli serwer proxy obsługuje ruch bezpośrednio z apache/nginx do tej usługi, to możesz użyć adres URL taki jak . Zalecane dla osób (aby uniknąć problemów), które nie mają dostępu do niestandardowych portów.


 * For MediaWiki 1.35 and later,  is the location of your wiki's  . For example, MediaWiki's REST endpoint is mediawiki.org/w/rest.php. See.
 * In MediaWiki 1.34 and earlier, using, the  entry must correspond to the URL and port of your Parsoid server. Jeśli twoje serwery Parsoid i RESTBase znajdują się na tym samym komputerze, to   jest prawidłowym adresem URL. Parsoid/JS used   as its default.


 * dbname: RESTBase, do przechowywania danych z pamięci podręcznej, użyje domyślnie bazy danych sqlite. Plik w skrypcie przykładowym ma nazwę db.sqlite3 i znajduje się w tym samym katalogu folderu RESTBase. Jeśli chcesz uruchomić RESTBase jako usługę później, będziesz mógł umieścić bazę danych w innym folderze, w którym użytkownik uruchamiający usługę miałby uprawnienia do zapisu. W tym celu możesz zmienić linię na:  (oraz mieć zapewnienie, że konto użytkownika, na którym działa usługa, ma uprawnienia do pisania na nim). Please note: You must manually add   parameter since they introduced storage groups for SQLite (see 225579).

Jeśli chcesz obsługiwać żądania z wielu stron wiki na tym samym serwerze RESTBase, powinieneś skopiować i powtórzyć całą sekcję, w razie potrzeby zmieniając konfigurację.
 * In MediaWiki 1.35 and later you need to call Parsoid via your "LocalSettings.php" file in case the is not installed for the wiki:

Uruchom serwer i przetestuj
Aby przetestować, czy działa, w folderze RESTbase uruchom: Do testowania, gdy jest uruchomiony, na innym terminalu wykonaj: Powinieneś zobaczyć zawartość HTML strony głównej. W przeglądarce możesz także przetestować, przechodząc do np. http://localhost:7231/v1/ powinieneś zobaczyć stronę zatytułowaną Wikimedia REST API. Na tej stronie możesz przetestować wszystkie metody i zmienne RESTBase. W przypadku innych testów patrz GitHub.

Jeśli port RESTBase jest zablokowany
If you do not see the page (your browser says it can't connect), your restbase server port may be blocked. Do the following:


 * If you get, your restbase server port is ok.
 * If you did not get, then do:
 * If you get  the restbase server is not bad, but you cannot access the port.

To bypass the block, you can set proxypass to your Apache httpd configuration. See the Proxy requests to RESTBase from your webserver section for instructions.

Starting RESTBase Server automatically
Create a new user for the RESTBase service (optional, but recommended to avoid running it as root) and create a home folder for that user: For installing the RESTBase server as a service with systemd, create this file in the  directory (  for CentOS 7 and   for openSUSE) and name it. Replace  with the path to your restbase project directory.

To automatically start the RESTBase server at system startup, To control the RESTBase server, If you ever change the  script, you need to reload it with,

Proxy requests to RESTBase from your webserver
RESTBase must be accessible from the visitors of your site for some functions to work properly. Having RESTBase on a non-standard http port is problematic for some users behind a corporate proxy or firewall. To solve this, and specially to serve requests to RESTBase through HTTPS, you should set up a reverse-proxy on your webserver that would route requests at a given path of your wiki to the RESTBase server.

Apache
If you use apache, you can make a  file like this, and put on   of YOUR_RESTBASE_SERVER.

Nginx
On the general configuration: Inside the  block: {{#tag:syntaxhighlight| {{tmpl|0= location /$1/v1/ {
 * 1) Alternate configuration like WMF to have URLS like //example.com/api/rest_v1/
 * 2) location /api/rest_v1/ {

proxy_pass http://restbase/$1/v1/$restbasequery; } }} }}
 * 1 = YOUR_WIKI_WEBSITE
 * lang = "nginx"

Configuring config.yaml for WMF like URLS
If you don't want to get a fetch error when using WMF like URLS, you should add  to the   module like so:

Testing
You should restart httpd (by  or some means). In a browser you can now navigate to:

(alternate url like WMF setup):

and you should see a page titled Wikimedia REST API. And in this setting, you should add below to  for VisualEditor.