doc: add section "Script manager" (user's guide)

1 files changed, 109 insertions, 52 deletions

diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc
index efa664524..4d7106696 100644
--- a/doc/pl/weechat_user.pl.adoc
+++ b/doc/pl/weechat_user.pl.adoc
@@ -232,13 +232,13 @@ Lista popularnych opcji:
   Kompilacja <<fset,wtyczki fset>>.
 
 | ENABLE_GUILE | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki guile>> (Scheme).
+  Kompilacja <<scripting_plugins,wtyczki guile>> (Scheme).
 
 | ENABLE_IRC | `ON`, `OFF` | ON |
   Kompilacja <<irc,wtyczki IRC>>.
 
 | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF |
-  Kompilacja <<scripts_plugins,wtyczki javascript>>.
+  Kompilacja <<scripting_plugins,wtyczki javascript>>.
 
 | ENABLE_LARGEFILE | `ON`, `OFF` | ON |
   Wsparcie dla dużych plików.
@@ -247,7 +247,7 @@ Lista popularnych opcji:
   Kompilacja <<buffer_logging,wtyczki logger>>.
 
 | ENABLE_LUA | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki lua>>.
+  Kompilacja <<scripting_plugins,wtyczki lua>>.
 
 | ENABLE_NCURSES | `ON`, `OFF` | ON |
   Kompilacja interfejsu Ncurses.
@@ -256,35 +256,35 @@ Lista popularnych opcji:
   Włączenie NLS (tłumaczenia).
 
 | ENABLE_PERL | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki perl>>.
+  Kompilacja <<scripting_plugins,wtyczki perl>>.
 
 | ENABLE_PHP | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki PHP>>.
+  Kompilacja <<scripting_plugins,wtyczki PHP>>.
 
 | ENABLE_PYTHON | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki Python>>.
+  Kompilacja <<scripting_plugins,wtyczki Python>>.
 
 | ENABLE_PYTHON2 | `ON`, `OFF` | OFF |
-  Kompilacja <<scripts_plugins,wtyczki Python>> z użyciem Pythona 2 zamiast Pythona 3.
+  Kompilacja <<scripting_plugins,wtyczki Python>> z użyciem Pythona 2 zamiast Pythona 3.
 
 | ENABLE_RELAY | `ON`, `OFF` | ON |
   Kompilacja <<relay,wtyczki relay>>.
 
 | ENABLE_RUBY | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki ruby>>.
+  Kompilacja <<scripting_plugins,wtyczki ruby>>.
 
 | ENABLE_SCRIPT | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki script>>.
+  Kompilacja <<script_manager,wtyczki script>>.
 
 | ENABLE_SCRIPTS | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczek skryptowych>> (Python, Perl, Ruby, Lua,
+  Kompilacja <<scripting_plugins,wtyczek skryptowych>> (Python, Perl, Ruby, Lua,
   Tcl, Guile, JavaScript, PHP).
 
 | ENABLE_SPELL | `ON`, `OFF` | ON |
   Kompilacja <<spell_checking,wtyczki spell>>.
 
 | ENABLE_TCL | `ON`, `OFF` | ON |
-  Kompilacja <<scripts_plugins,wtyczki tcl>>.
+  Kompilacja <<scripting_plugins,wtyczki tcl>>.
 
 | ENABLE_TRIGGER | `ON`, `OFF` | ON |
   Kompilacja <<trigger,wtyczki trigger>>.
@@ -1880,7 +1880,8 @@ Poniższe skróty i akcje mogą zostać użyte w buforze fset (zobacz <<fset,wty
 [[key_bindings_script_buffer]]
 === Script buffer
 
-Te skróty klawiszowe i akcje mogą zostać użyte w oknie skryptów (zobacz <<scripts_plugins,wtyczka script>>).
+// TRANSLATION MISSING
+Te skróty klawiszowe i akcje mogą zostać użyte w oknie skryptów (zobacz <<script_manager,script manager>>).
 
 [width="100%",cols="^.^3,^.^2,.^8,.^5",options="header"]
 |===
@@ -4987,85 +4988,141 @@ Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleź
 link:weechat_plugin_api.en.html[Opisie API wtyczek] (Angielski) i
 link:weechat_scripting.pl.html[Poradniku pisania skryptów].
 
-[[scripts_plugins]]
+[[scripts]]
 === Skryptowe
 
 WeeChat posiada 8 wtyczek skryptowych: Python, Perl, Ruby, Lua, Tcl, Guile
 (scheme), JavaScript i PHP.
 Wtyczki te potrafią ładować, wykonywać i wyładowywać skrypty w tych językach.
 
-Inna wtyczka nazwana "script" jest managerem skryptów i jest używana do
-ładowania/wyładowywania skryptów w dowolnym języku, oraz do instalacji/usuwania
-skryptów z repozytorium skryptów WeeChat, dostępnego pod adresem:
-https://weechat.org/scripts
-
 Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można
 znaleźć w link:weechat_scripting.pl.html[Poradniku pisania skryptów].
 
+// TRANSLATION MISSING
+[[script_manager]]
+==== Script manager
+
+// TRANSLATION MISSING
+The script manager (command <<command_script_script,/script>>) is used to
+load/unload scripts of any language, and install/remove scripts of WeeChat
+scripts repository, which are visible at this URL: https://weechat.org/scripts
+
+// TRANSLATION MISSING
+For privacy considerations, the download of scripts is disabled by default. +
+To enable it, type this command:
+
+----
+/set script.scripts.download_enabled on
+----
+
+// TRANSLATION MISSING
+Then you can download the list of scripts and display them in a new buffer
+with the <<command_script_script,/script>> command:
+
+[subs="quotes,attributes"]
+:x: *
+....
+┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│1.weechat│368/368 scripts (filter: {x}) | Sort: i,p,n | Alt+key/input: i=install, r=remove, l=load, L=reload, u=│
+│2.scripts│{x}      autosort.py                 3.9     2020-10-11 | Automatically keep buffers grouped by server│
+│         │{x}      multiline.pl                0.6.3   2016-01-02 | Multi-line edit box, also supports editing o│
+│         │{x}      highmon.pl                  2.7     2020-06-21 | Adds a highlight monitor buffer.            │
+│         │##{x}ia r  grep.py               0.8.5 0.8.5   2021-05-11 | Search regular expression in buffers or log ##│
+│         │{x}      autojoin.py                 0.3.1   2019-10-06 | Configure autojoin for all servers according│
+│         │{x}      colorize_nicks.py           28      2021-03-06 | Use the weechat nick colors in the chat area│
+│         │{x}ia r  go.py                 2.7   2.7     2021-05-26 | Quick jump to buffers.                      │
+│         │{x}      text_item.py                0.9     2019-05-25 | Add bar items with plain text.              │
+│         │       aesthetic.py                1.0.6   2020-10-25 | Make messages more A E S T H E T I C A L L Y│
+│         │       aformat.py                  0.2     2018-06-21 | Alternate text formatting, useful for relays│
+│         │       alternatetz.py              0.3     2018-11-11 | Add an alternate timezone item.             │
+│         │       amarok2.pl                  0.7     2012-05-08 | Amarok 2 control and now playing script.    │
+│         │       amqp_notify.rb              0.1     2011-01-12 | Send private messages and highlights to an A│
+│         │       announce_url_title.py       19      2021-06-05 | Announce URL title to user or to channel.   │
+│         │       anotify.py                  1.0.2   2020-05-16 | Notifications of private messages, highlight│
+│         │       anti_password.py            1.2.1   2021-03-13 | Prevent a password from being accidentally s│
+│         │       apply_corrections.py        1.3     2018-06-21 | Display corrected text when user sends s/typ│
+│         │       arespond.py                 0.1.1   2020-10-11 | Simple autoresponder.                       │
+│         │       atcomplete.pl               0.001   2016-10-29 | Tab complete nicks when prefixed with "@".  │
+│         │       audacious.pl                0.3     2009-05-03 | Display which song Audacious is currently pl│
+│         │       auth.rb                     0.3     2014-05-30 | Automatically authenticate with NickServ usi│
+│         │       auto_away.py                0.4     2018-11-11 | A simple auto-away script.                  │
+│         │       autoauth.py                 1.3     2021-11-07 | Permits to auto-authenticate when changing n│
+│         │       autobump.py                 0.1.0   2019-06-14 | Bump buffers upon activity.                 │
+│         │       autoconf.py                 0.4     2021-05-11 | Auto save/load changed options in a .weerc f│
+│         │       autoconnect.py              0.3.3   2019-10-06 | Reopen servers and channels opened last time│
+│         │[12:55] [2] [script] 2:scripts                                                                      │
+│         │█                                                                                                   │
+└──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+....
+
 [[script_commands]]
-==== Komendy wtyczki script
+===== Komendy wtyczki script
 
 include::includes/autogen_user_commands.pl.adoc[tag=script_commands]
 
+[[script_options]]
+===== Opcje wtyczki script
+
+Sekcje w pliku _script.conf_:
+
+[width="100%",cols="3m,6m,16",options="header"]
+|===
+| Sekcja  | Komenda               | Opis
+| look    | /set script.look.*    | Wygląd.
+| color   | /set script.color.*   | Kolory.
+| scripts | /set script.scripts.* | Opcja dla pobierania skryptów.
+|===
+
+Opcje:
+
+include::includes/autogen_user_options.pl.adoc[tag=script_options]
+
+// TRANSLATION MISSING
+[[scripting_plugins]]
+==== Scripting plugins
+
 [[python_commands]]
-==== Komendy wtyczki python
+===== Komendy wtyczki python
 
 include::includes/autogen_user_commands.pl.adoc[tag=python_commands]
 
 [[perl_commands]]
-==== Komendy wtyczki perl
+===== Komendy wtyczki perl
 
 include::includes/autogen_user_commands.pl.adoc[tag=perl_commands]
 
 [[ruby_commands]]
-==== Komendy wtyczki ruby
+===== Komendy wtyczki ruby
 
 include::includes/autogen_user_commands.pl.adoc[tag=ruby_commands]
 
 [[lua_commands]]
-==== Komendy wtyczki lua
+===== Komendy wtyczki lua
 
 include::includes/autogen_user_commands.pl.adoc[tag=lua_commands]
 
 [[tcl_commands]]
-==== Komendy wtyczki tcl
+===== Komendy wtyczki tcl
 
 include::includes/autogen_user_commands.pl.adoc[tag=tcl_commands]
 
 [[guile_commands]]
-==== Komendy wtyczki guile
+===== Komendy wtyczki guile
 
 include::includes/autogen_user_commands.pl.adoc[tag=guile_commands]
 
 [[javascript_commands]]
-==== Komendy wtyczki javascript
+===== Komendy wtyczki javascript
 
 include::includes/autogen_user_commands.pl.adoc[tag=javascript_commands]
 
 [[php_commands]]
-==== Komendy wtyczki php
+===== Komendy wtyczki php
 
 include::includes/autogen_user_commands.pl.adoc[tag=php_commands]
 
-[[script_options]]
-==== Opcje wtyczki script
-
-Sekcje w pliku _script.conf_:
-
-[width="100%",cols="3m,6m,16",options="header"]
-|===
-| Sekcja  | Komenda               | Opis
-| look    | /set script.look.*    | Wygląd.
-| color   | /set script.color.*   | Kolory.
-| scripts | /set script.scripts.* | Opcja dla pobierania skryptów.
-|===
-
-Opcje:
-
-include::includes/autogen_user_options.pl.adoc[tag=script_options]
-
 [[python_options]]
-==== Opcje dla języka Python
+===== Opcje dla języka Python
 
 Sekcje w pliku _python.conf_:
 
@@ -5080,7 +5137,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=python_options]
 
 [[perl_options]]
-==== Opcje dla języka Perl
+===== Opcje dla języka Perl
 
 Sekcje w pliku _perl.conf_:
 
@@ -5095,7 +5152,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=perl_options]
 
 [[ruby_options]]
-==== Opcje dla języka Ruby
+===== Opcje dla języka Ruby
 
 Sekcje w pliku _ruby.conf_:
 
@@ -5110,7 +5167,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=ruby_options]
 
 [[lua_options]]
-==== Opcje dla języka Lua
+===== Opcje dla języka Lua
 
 Sekcje w pliku _lua.conf_:
 
@@ -5125,7 +5182,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=lua_options]
 
 [[tcl_options]]
-==== Opcje dla języka Tcl
+===== Opcje dla języka Tcl
 
 Sekcje w pliku _tcl.conf_:
 
@@ -5140,7 +5197,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=tcl_options]
 
 [[guile_options]]
-==== Opcje dla języka Guile
+===== Opcje dla języka Guile
 
 Sekcje w pliku _guile.conf_:
 
@@ -5155,7 +5212,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=guile_options]
 
 [[javascript_options]]
-==== Opcje dla języka Javascript
+===== Opcje dla języka Javascript
 
 Sekcje w pliku _javascript.conf_:
 
@@ -5170,7 +5227,7 @@ Opcje:
 include::includes/autogen_user_options.pl.adoc[tag=javascript_options]
 
 [[php_options]]
-==== Opcje dla języka PHP
+===== Opcje dla języka PHP
 
 Sekcje w pliku _php.conf_: