From 49ac7dd9f59df233e0e8294178b5fd094c28def0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Fri, 19 Feb 2021 20:12:18 +0100 Subject: [PATCH] doc: split dependencies in two tables: required and optional (user's guide) --- doc/de/weechat_user.de.adoc | 76 ++++++++++++++++++-------------- doc/en/weechat_user.en.adoc | 74 +++++++++++++++++-------------- doc/fr/weechat_user.fr.adoc | 72 ++++++++++++++++-------------- doc/it/weechat_user.it.adoc | 87 +++++++++++++++++++++---------------- doc/ja/weechat_user.ja.adoc | 76 ++++++++++++++++++-------------- doc/pl/weechat_user.pl.adoc | 75 ++++++++++++++++++-------------- 6 files changed, 262 insertions(+), 198 deletions(-) diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 4cf1865c6..c82face0b 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -95,39 +95,22 @@ Unter macOS kann https://brew.sh/[Homebrew] verwendet werden: [[dependencies]] ==== Abhängigkeiten -folgende Tabelle beschreibt, welche Pakete zwingend notwendig sind um WeeChat -zu kompilieren und welche Pakete optional genutzt werden können. +// TRANSLATION MISSING +The following table shows the list of packages that are *required* to compile +WeeChat: -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| Paket ^(1)^ | Version | benötigt | Funktion +| Paket ^(1)^ | Version | Funktion | C compiler - (gcc, clang, ...) | | *ja* | zum Erstellen der Binärdatei. -| C++ compiler | | | zum Erstellen der Binärdatei und um Test auszuführen, JavaScript Erweiterung. -| cmake | ≥ 3.0 | *ja* | zum kompilieren (autotools ist möglich. CMake wird aber empfohlen). -| pkg-config | | *ja* | entdeckt installierte Bibliotheken. -| libncursesw5-dev ^(2)^ | | *ja* | Ncurses Oberfläche. -| libcurl4-gnutls-dev | | *ja* | URL Transfer. -| zlib1g-dev | | *ja* | Kompression für Pakete, die mittels Relay- (WeeChat Protokoll), Script-Erweiterung übertragen werden. -| libgcrypt20-dev | | *ja* | Geschützte Daten, IRC SASL Authentifikation (DH-BLOWFISH/DH-AES). -| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | *ja* | SSL Verbindung zu einem IRC Server, Unterstützung von SSL in der Relay-Erweiterung, IRC SASL Authentifikation (ECDSA-NIST256P-CHALLENGE). -| gettext | | | Internationalisierung (Übersetzung der Mitteilungen; Hauptsprache ist englisch). -| ca-certificates | | | Zertifikate für SSL Verbindungen. -| libaspell-dev - ∥ libenchant-dev | | | Spell Erweiterung. -| python3-dev | ^(4)^ | | Python Erweiterung. -| libperl-dev | | | Perl Erweiterung. -| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | | Ruby Erweiterung. -| liblua5.3-dev | | | Lua Erweiterung. -| tcl-dev | ≥ 8.5 | | Tcl Erweiterung. -| guile-2.0-dev | ≥ 2.0 | | Guile (scheme) Erweiterung. -| libv8-dev | ≤ 3.24.3 | | JavaScript Erweiterung. -| php-dev, libphp-embed | ≥ 7.0 | | PHP Erweiterung. -| libxml2-dev | | | PHP Erweiterung. -| libargon2-0-dev | | | PHP Erweiterung (wenn PHP ≥ 7.2). -| libsodium-dev | | | PHP Erweiterung (wenn PHP ≥ 7.2). -| asciidoctor | ≥ 1.5.4 | | zum Erstellen der man page und der Dokumentation. -| libcpputest-dev | ≥ 3.4 | | zum Erstellen und um Test auszuführen. + (gcc, clang, ...) | | zum Erstellen der Binärdatei. +| cmake | ≥ 3.0 | zum kompilieren (autotools ist möglich. CMake wird aber empfohlen). +| pkg-config | | entdeckt installierte Bibliotheken. +| libncursesw5-dev ^(2)^ | | Ncurses Oberfläche. +| libcurl4-gnutls-dev | | URL Transfer. +| zlib1g-dev | | Kompression für Pakete, die mittels Relay- (WeeChat Protokoll), Script-Erweiterung übertragen werden. +| libgcrypt20-dev | | Geschützte Daten, IRC SASL Authentifikation (DH-BLOWFISH/DH-AES). +| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | SSL Verbindung zu einem IRC Server, Unterstützung von SSL in der Relay-Erweiterung, IRC SASL Authentifikation (ECDSA-NIST256P-CHALLENGE). |=== [NOTE] @@ -138,8 +121,37 @@ entscheidend) zu kompilieren. Eine Kompilierung kann auch mit libncurses5-dev er aber dies wird *NICHT* empfohlen: Es können Darstellungsfehler mit breiten Zeichen auftreten. + ^(3)^ GnuTLS ≥ 3.0.21 wird benötigt um eine IRC SASL Authentifizierung mittels -ECDSA-NIST256P-CHALLENGE durchzuführen. + -^(4)^ standardmäßig wird Python 3.x verwendet. Wird die Option `+ENABLE_PYTHON2+` aktiviert +ECDSA-NIST256P-CHALLENGE durchzuführen. + +// TRANSLATION MISSING +The following table shows the list of packages that are optional to compile +WeeChat: + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| Paket | Version | Funktion +| C++ compiler | | zum Erstellen der Binärdatei und um Test auszuführen, JavaScript Erweiterung. +| gettext | | Internationalisierung (Übersetzung der Mitteilungen; Hauptsprache ist englisch). +| ca-certificates | | Zertifikate für SSL Verbindungen. +| libaspell-dev + ∥ libenchant-dev | | Spell Erweiterung. +| python3-dev ^(1)^ | | Python Erweiterung. +| libperl-dev | | Perl Erweiterung. +| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | Ruby Erweiterung. +| liblua5.3-dev | | Lua Erweiterung. +| tcl-dev | ≥ 8.5 | Tcl Erweiterung. +| guile-2.0-dev | ≥ 2.0 | Guile (scheme) Erweiterung. +| libv8-dev | ≤ 3.24.3 | JavaScript Erweiterung. +| php-dev, libphp-embed | ≥ 7.0 | PHP Erweiterung. +| libxml2-dev | | PHP Erweiterung. +| libargon2-0-dev | | PHP Erweiterung (wenn PHP ≥ 7.2). +| libsodium-dev | | PHP Erweiterung (wenn PHP ≥ 7.2). +| asciidoctor | ≥ 1.5.4 | zum Erstellen der man page und der Dokumentation. +| libcpputest-dev | ≥ 3.4 | zum Erstellen und um Test auszuführen. +|=== + +[NOTE] +^(1)^ standardmäßig wird Python 3.x verwendet. Wird die Option `+ENABLE_PYTHON2+` aktiviert (siehe unten), sollte die Version 2.7 von Python genutzt werden. Falls eine Debian/Ubuntu basierte Distribution genutzt wird und man einen diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 3c52531d0..c34383658 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -89,39 +89,21 @@ On macOS, you can use https://brew.sh/[Homebrew]: [[dependencies]] ==== Dependencies -Following table shows list of packages that are required or optional to -compile WeeChat. +The following table shows the list of packages that are *required* to compile +WeeChat: -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| Package ^(1)^ | Version | Required | Feature +| Package ^(1)^ | Version | Feature | C compiler - (gcc, clang, ...) | | *yes* | Build. -| C++ compiler | | | Build and run tests, JavaScript plugin. -| cmake | ≥ 3.0 | *yes* | Build (autotools still possible, but CMake is recommended). -| pkg-config | | *yes* | Detect installed libraries. -| libncursesw5-dev ^(2)^ | | *yes* | Ncurses interface. -| libcurl4-gnutls-dev | | *yes* | URL transfer. -| zlib1g-dev | | *yes* | Compression of packets in relay plugin (weechat protocol), script plugin. -| libgcrypt20-dev | | *yes* | Secured data, IRC SASL authentication (DH-BLOWFISH/DH-AES). -| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | *yes* | SSL connection to IRC server, support of SSL in relay plugin, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE). -| gettext | | | Internationalization (translation of messages; base language is English). -| ca-certificates | | | Certificates for SSL connections. -| libaspell-dev - ∥ libenchant-dev | | | Spell plugin. -| python3-dev | ^(4)^ | | Python plugin. -| libperl-dev | | | Perl plugin. -| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | | Ruby plugin. -| liblua5.3-dev | | | Lua plugin. -| tcl-dev | ≥ 8.5 | | Tcl plugin. -| guile-2.0-dev | ≥ 2.0 | | Guile (scheme) plugin. -| libv8-dev | ≤ 3.24.3 | | JavaScript plugin. -| php-dev, libphp-embed | ≥ 7.0 | | PHP plugin. -| libxml2-dev | | | PHP plugin. -| libargon2-0-dev | | | PHP plugin (if PHP ≥ 7.2). -| libsodium-dev | | | PHP plugin (if PHP ≥ 7.2). -| asciidoctor | ≥ 1.5.4 | | Build man page and documentation. -| libcpputest-dev | ≥ 3.4 | | Build and run tests. + (gcc, clang, ...) | | Build. +| cmake | ≥ 3.0 | Build (autotools still possible, but CMake is recommended). +| pkg-config | | Detect installed libraries. +| libncursesw5-dev ^(2)^ | | Ncurses interface. +| libcurl4-gnutls-dev | | URL transfer. +| zlib1g-dev | | Compression of packets in relay plugin (weechat protocol), script plugin. +| libgcrypt20-dev | | Secured data, IRC SASL authentication (DH-BLOWFISH/DH-AES). +| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | SSL connection to IRC server, support of SSL in relay plugin, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE). |=== [NOTE] @@ -131,8 +113,36 @@ names may be different in different distributions and versions. + important). WeeChat can compile with libncurses5-dev, but it is *NOT* recommended: you may experience display bugs with wide chars. + ^(3)^ GnuTLS ≥ 3.0.21 is required for IRC SASL authentication with mechanism -ECDSA-NIST256P-CHALLENGE. + -^(4)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` +ECDSA-NIST256P-CHALLENGE. + +The following table shows the list of packages that are optional to compile +WeeChat: + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| Package | Version | Feature +| C++ compiler | | Build and run tests, JavaScript plugin. +| gettext | | Internationalization (translation of messages; base language is English). +| ca-certificates | | Certificates for SSL connections. +| libaspell-dev + ∥ libenchant-dev | | Spell plugin. +| python3-dev ^(1)^ | | Python plugin. +| libperl-dev | | Perl plugin. +| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | Ruby plugin. +| liblua5.3-dev | | Lua plugin. +| tcl-dev | ≥ 8.5 | Tcl plugin. +| guile-2.0-dev | ≥ 2.0 | Guile (scheme) plugin. +| libv8-dev | ≤ 3.24.3 | JavaScript plugin. +| php-dev, libphp-embed | ≥ 7.0 | PHP plugin. +| libxml2-dev | | PHP plugin. +| libargon2-0-dev | | PHP plugin (if PHP ≥ 7.2). +| libsodium-dev | | PHP plugin (if PHP ≥ 7.2). +| asciidoctor | ≥ 1.5.4 | Build man page and documentation. +| libcpputest-dev | ≥ 3.4 | Build and run tests. +|=== + +[NOTE] +^(1)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` (see below), only the version 2.7 of Python is recommended. If you are using a Debian/Ubuntu based distribution, and if you have some diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index f25289ec8..44d5f3f92 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -93,39 +93,20 @@ Sous macOS, vous pouvez utiliser https://brew.sh/[Homebrew] : [[dependencies]] ==== Dépendances -Le tableau suivant liste les paquets qui sont requis ou optionnels pour -compiler WeeChat. +Le tableau suivant liste les paquets qui sont *requis* pour compiler WeeChat : -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| Paquet ^(1)^ | Version | Requis | Fonctionnalité +| Paquet ^(1)^ | Version | Fonctionnalité | compilateur C - (gcc, clang, ...) | | *oui* | Construction. -| compilateur C++ | | | Construction et lancement des tests, extension JavaScript. -| cmake | ≥ 3.0 | *oui* | Construction (autotools toujours possible, mais CMake est recommandé). -| pkg-config | | *oui* | Détection des bibliothèques installées. -| libncursesw5-dev ^(2)^ | | *oui* | Interface ncurses. -| libcurl4-gnutls-dev | | *oui* | Transfert d'URL. -| zlib1g-dev | | *oui* | Compression des paquets dans l'extension relay (protocole weechat), extension script. -| libgcrypt20-dev | | *oui* | Données sécurisées, authentification IRC SASL (DH-BLOWFISH/DH-AES). -| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | *oui* | Connexion SSL au serveur IRC, support SSL dans l'extension relay, authentification IRC SASL (ECDSA-NIST256P-CHALLENGE). -| gettext | | | Internationalisation (traduction des messages ; la langue de base est l'anglais). -| ca-certificates | | | Certificats pour les connexions SSL. -| libaspell-dev - ∥ libenchant-dev | | | Extension spell. -| python3-dev | ^(4)^ | | Extension python. -| libperl-dev | | | Extension perl. -| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | | Extension ruby. -| liblua5.3-dev | | | Extension lua. -| tcl-dev | ≥ 8.5 | | Extension tcl. -| guile-2.0-dev | ≥ 2.0 | | Extension guile (scheme). -| libv8-dev | ≤ 3.24.3 | | Extension javascript. -| php-dev, libphp-embed | ≥ 7.0 | | Extension PHP. -| libxml2-dev | | | Extension PHP. -| libargon2-0-dev | | | Extension PHP (si PHP ≥ 7.2). -| libsodium-dev | | | Extension PHP (si PHP ≥ 7.2). -| asciidoctor | ≥ 1.5.4 | | Construction de la page man et de la documentation. -| libcpputest-dev | ≥ 3.4 | | Construction et lancement des tests. + (gcc, clang, ...) | | Construction. +| cmake | ≥ 3.0 | Construction (autotools toujours possible, mais CMake est recommandé). +| pkg-config | | Détection des bibliothèques installées. +| libncursesw5-dev ^(2)^ | | Interface ncurses. +| libcurl4-gnutls-dev | | Transfert d'URL. +| zlib1g-dev | | Compression des paquets dans l'extension relay (protocole weechat), extension script. +| libgcrypt20-dev | | Données sécurisées, authentification IRC SASL (DH-BLOWFISH/DH-AES). +| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | Connexion SSL au serveur IRC, support SSL dans l'extension relay, authentification IRC SASL (ECDSA-NIST256P-CHALLENGE). |=== [NOTE] @@ -136,8 +117,35 @@ important). WeeChat peut compiler avec libncurses5-dev, but ce n'est *PAS* recommandé : vous pourriez avoir des bugs d'affichage avec les caractères larges. + ^(3)^ GnuTLS ≥ 3.0.21 est requis pour l'authentification SASL avec le mécanisme -ECDSA-NIST256P-CHALLENGE. + -^(4)^ Par défaut Python 3.x est utilisé. Si vous activez l'option +ECDSA-NIST256P-CHALLENGE. + +Le tableau suivant liste les paquets qui sont optionnels pour compiler WeeChat : + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| Paquet | Version | Fonctionnalité +| compilateur C++ | | Construction et lancement des tests, extension JavaScript. +| gettext | | Internationalisation (traduction des messages ; la langue de base est l'anglais). +| ca-certificates | | Certificats pour les connexions SSL. +| libaspell-dev + ∥ libenchant-dev | | Extension spell. +| python3-dev ^(1)^ | | Extension python. +| libperl-dev | | Extension perl. +| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | Extension ruby. +| liblua5.3-dev | | Extension lua. +| tcl-dev | ≥ 8.5 | Extension tcl. +| guile-2.0-dev | ≥ 2.0 | Extension guile (scheme). +| libv8-dev | ≤ 3.24.3 | Extension javascript. +| php-dev, libphp-embed | ≥ 7.0 | Extension PHP. +| libxml2-dev | | Extension PHP. +| libargon2-0-dev | | Extension PHP (si PHP ≥ 7.2). +| libsodium-dev | | Extension PHP (si PHP ≥ 7.2). +| asciidoctor | ≥ 1.5.4 | Construction de la page man et de la documentation. +| libcpputest-dev | ≥ 3.4 | Construction et lancement des tests. +|=== + +[NOTE] +^(1)^ Par défaut Python 3.x est utilisé. Si vous activez l'option `+ENABLE_PYTHON2+` (voir ci-dessous), seule la version 2.7 de Python est recommandée. diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index c4df291f2..78d9a2978 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -106,52 +106,29 @@ On macOS, you can use https://brew.sh/[Homebrew]: [[dependencies]] ==== Dipendenze -La seguente tabella mostra l'elenco di pacchetti richiesti o opzionali per -compilare WeeChat. +// TRANSLATION MISSING +The following table shows the list of packages that are *required* to compile +WeeChat: -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| Pacchetto ^(1)^ | Versione | Richiesto | Caratteristica +| Pacchetto ^(1)^ | Versione | Caratteristica // TRANSLATION MISSING | C compiler - (gcc, clang, ...) | | *sì* | Build. + (gcc, clang, ...) | | Build. +| cmake | ≥ 3.0 | Compilazione (ancora possibile con autotools, ma si raccomanda CMake). // TRANSLATION MISSING -| C++ compiler | | | Build and run tests, plugin JavaScript. -| cmake | ≥ 3.0 | *sì* | Compilazione (ancora possibile con autotools, ma si raccomanda CMake). +| pkg-config | | Detect installed libraries. +| libncursesw5-dev ^(2)^ | | Interfaccia ncurses. +| libcurl4-gnutls-dev | | Trasferimento URL. // TRANSLATION MISSING -| pkg-config | | *sì* | Detect installed libraries. -| libncursesw5-dev ^(2)^ | | *sì* | Interfaccia ncurses. -| libcurl4-gnutls-dev | | *sì* | Trasferimento URL. +| zlib1g-dev | | Compression of packets in relay plugin (weechat protocol), script plugin. // TRANSLATION MISSING -| zlib1g-dev | | *sì* | Compression of packets in relay plugin (weechat protocol), script plugin. +| libgcrypt20-dev | | Secured data, IRC SASL authentication (DH-BLOWFISH/DH-AES). // TRANSLATION MISSING -| libgcrypt20-dev | | *sì* | Secured data, IRC SASL authentication (DH-BLOWFISH/DH-AES). -// TRANSLATION MISSING -| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | *sì* | Connessione SSL al server IRC, support of SSL in relay plugin, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE). -| gettext | | | Internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese). -| ca-certificates | | | Certificati per le connessioni SSL. -| libaspell-dev - ∥ libenchant-dev | | | Plugin spell. -| python3-dev | ^(4)^ | | Plugin python. -| libperl-dev | | | Plugin perl. -| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | | Plugin ruby. -| liblua5.3-dev | | | Plugin lua. -| tcl-dev | ≥ 8.5 | | Plugin tcl. -| guile-2.0-dev | ≥ 2.0 | | Plugin guile (scheme). -| libv8-dev | ≤ 3.24.3 | | Plugin javascript. -| php-dev, libphp-embed | ≥ 7.0 | | Plugin php. -| libxml2-dev | | | Plugin php. -// TRANSLATION MISSING -| libargon2-0-dev | | | Plugin php (if PHP ≥ 7.2). -// TRANSLATION MISSING -| libsodium-dev | | | Plugin php (if PHP ≥ 7.2). -// TRANSLATION MISSING -| asciidoctor | ≥ 1.5.4 | | Build man page and documentation. -// TRANSLATION MISSING -| libcpputest-dev | ≥ 3.4 | | Build and run tests. +| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | Connessione SSL al server IRC, support of SSL in relay plugin, IRC SASL authentication (ECDSA-NIST256P-CHALLENGE). |=== -// TRANSLATION MISSING (note 3) [NOTE] ^(1)^ Il nome viene dalla distribuzione Debian GNU/Linux, nomi e versioni dei pacchetti potrebbero essere differenti in versioni e distribuzioni differenti. + @@ -161,9 +138,43 @@ important). WeeChat can compile with libncurses5-dev, but it is *NOT* recommende you may experience display bugs with wide chars. + // TRANSLATION MISSING ^(3)^ GnuTLS ≥ 3.0.21 is required for IRC SASL authentication with mechanism -ECDSA-NIST256P-CHALLENGE. + +ECDSA-NIST256P-CHALLENGE. + // TRANSLATION MISSING -^(4)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` (see +The following table shows the list of packages that are optional to compile +WeeChat: + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| Pacchetto | Versione | Caratteristica +// TRANSLATION MISSING +| C++ compiler | | Build and run tests, plugin JavaScript. +| gettext | | Internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese). +| ca-certificates | | Certificati per le connessioni SSL. +| libaspell-dev + ∥ libenchant-dev | | Plugin spell. +| python3-dev ^(1)^ | | Plugin python. +| libperl-dev | | Plugin perl. +| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | Plugin ruby. +| liblua5.3-dev | | Plugin lua. +| tcl-dev | ≥ 8.5 | Plugin tcl. +| guile-2.0-dev | ≥ 2.0 | Plugin guile (scheme). +| libv8-dev | ≤ 3.24.3 | Plugin javascript. +| php-dev, libphp-embed | ≥ 7.0 | Plugin php. +| libxml2-dev | | Plugin php. +// TRANSLATION MISSING +| libargon2-0-dev | | Plugin php (if PHP ≥ 7.2). +// TRANSLATION MISSING +| libsodium-dev | | Plugin php (if PHP ≥ 7.2). +// TRANSLATION MISSING +| asciidoctor | ≥ 1.5.4 | Build man page and documentation. +// TRANSLATION MISSING +| libcpputest-dev | ≥ 3.4 | Build and run tests. +|=== + +[NOTE] +// TRANSLATION MISSING +^(1)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` (see below), only the version 2.7 of Python is recommended. // TRANSLATION MISSING diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index fa8a5961e..f0c725622 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -95,39 +95,22 @@ macOS では https://brew.sh/[Homebrew] を使ってください: [[dependencies]] ==== 依存関係 -以下の表は WeeChat -のコンパイルに必須または任意で必要なパッケージのリストです。 +// TRANSLATION MISSING +The following table shows the list of packages that are *required* to compile +WeeChat: -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| パッケージ ^(1)^ | バージョン | 要件 | 機能 +| パッケージ ^(1)^ | バージョン | 機能 | C コンパイラ - (gcc, clang, ...) | | *必須* | ビルド -| C++ コンパイラ | | | ビルドとテストの実行、JavaScript プラグイン -| cmake | ≥ 3.0 | *必須* | ビルド (autotools でも可能ですが、CMake を推奨します) -| pkg-config | | *必須* | インストール済みライブラリを検出 -| libncursesw5-dev ^(2)^ | | *必須* | ncurses インターフェース -| libcurl4-gnutls-dev | | *必須* | URL 転送 -| zlib1g-dev | | *必須* | relay プラグインでパケットを圧縮 (weechat プロトコル)、スクリプトプラグイン -| libgcrypt20-dev | | *必須* | 保護データ、IRC SASL 認証 (DH-BLOWFISH/DH-AES) -| libgnutls28-dev | 2.2.0 以上 ^(3)^ | *必須* | IRC サーバへの SSL 接続、IRC SASL 認証 (ECDSA-NIST256P-CHALLENGE) -| gettext | | | 国際化 (メッセージの翻訳; ベース言語は英語です) -| ca-certificates | | | SSL 接続に必要な証明書、relay プラグインで SSL サポート -| libaspell-dev - ∥ libenchant-dev | | | spell プラグイン -| python3-dev | ^(4)^ | | python プラグイン -| libperl-dev | | | perl プラグイン -| ruby2.5, ruby2.5-dev | 1.9.1 以上 | | ruby プラグイン -| liblua5.3-dev | | | lua プラグイン -| tcl-dev | 8.5 以上 | | tcl プラグイン -| guile-2.0-dev | 2.0 以上 | | guile (scheme) プラグイン -| libv8-dev | 3.24.3 以下 | | javascript プラグイン -| php-dev, libphp-embed | 7.0 以上 | | PHP プラグイン -| libxml2-dev | | | PHP プラグイン -| libargon2-0-dev | | | PHP プラグイン (PHP 7.2 以上の場合) -| libsodium-dev | | | PHP プラグイン (PHP 7.2 以上の場合) -| asciidoctor | 1.5.4 以上 | | man ページと文書のビルド -| libcpputest-dev | 3.4 以上 | | ビルドとテストの実行 + (gcc, clang, ...) | | ビルド +| cmake | ≥ 3.0 | ビルド (autotools でも可能ですが、CMake を推奨します) +| pkg-config | | インストール済みライブラリを検出 +| libncursesw5-dev ^(2)^ | | ncurses インターフェース +| libcurl4-gnutls-dev | | URL 転送 +| zlib1g-dev | | relay プラグインでパケットを圧縮 (weechat プロトコル)、スクリプトプラグイン +| libgcrypt20-dev | | 保護データ、IRC SASL 認証 (DH-BLOWFISH/DH-AES) +| libgnutls28-dev | 2.2.0 以上 ^(3)^ | IRC サーバへの SSL 接続、IRC SASL 認証 (ECDSA-NIST256P-CHALLENGE) |=== [NOTE] @@ -137,9 +120,38 @@ macOS では https://brew.sh/[Homebrew] を使ってください: (*w* が重要です)。libncurses5-dev でもコンパイル可能ですが、これは推奨 *されません* (ワイドキャラクタの表示にバグを生じるでしょう)。 + ^(3)^ IRC SASL 認証で ECDSA-NIST256P-CHALLENGE を使うには、GnuTLS -バージョン 3.0.21 以上が必要です。 + +バージョン 3.0.21 以上が必要です。 + // TRANSLATION MISSING -^(4)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` (see +The following table shows the list of packages that are optional to compile +WeeChat: + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| パッケージ | バージョン | 機能 +| C++ コンパイラ | | ビルドとテストの実行、JavaScript プラグイン +| gettext | | 国際化 (メッセージの翻訳; ベース言語は英語です) +| ca-certificates | | SSL 接続に必要な証明書、relay プラグインで SSL サポート +| libaspell-dev + ∥ libenchant-dev | | spell プラグイン +| python3-dev ^(1)^ | | python プラグイン +| libperl-dev | | perl プラグイン +| ruby2.5, ruby2.5-dev | 1.9.1 以上 | ruby プラグイン +| liblua5.3-dev | | lua プラグイン +| tcl-dev | 8.5 以上 | tcl プラグイン +| guile-2.0-dev | 2.0 以上 | guile (scheme) プラグイン +| libv8-dev | 3.24.3 以下 | javascript プラグイン +| php-dev, libphp-embed | 7.0 以上 | PHP プラグイン +| libxml2-dev | | PHP プラグイン +| libargon2-0-dev | | PHP プラグイン (PHP 7.2 以上の場合) +| libsodium-dev | | PHP プラグイン (PHP 7.2 以上の場合) +| asciidoctor | 1.5.4 以上 | man ページと文書のビルド +| libcpputest-dev | 3.4 以上 | ビルドとテストの実行 +|=== + +[NOTE] +// TRANSLATION MISSING +^(1)^ By default Python 3.x is used. If you enable option `+ENABLE_PYTHON2+` (see below), only the version 2.7 of Python is recommended. Debian および Ubuntu diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index f3043c789..5b13d339b 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -95,39 +95,22 @@ Na macOS możesz użyć https://brew.sh/[Homebrew]: [[dependencies]] ==== Zależności -Poniższa tabela przedstawia pakiety wymagane i opcjonalne do skompilowania -WeeChat. +// TRANSLATION MISSING +The following table shows the list of packages that are *required* to compile +WeeChat: -[width="100%",cols="6,^3,^3,.^13",options="header"] +[width="100%",cols="5,^3,.^15",options="header"] |=== -| Pakiet ^(1)^ | Wersja | Wymagany | Opis +| Pakiet ^(1)^ | Wersja | Opis | kompilator C - (gcc, clang, ...) | | *tak* | Kompilacja. -| kompilator C++ | | | Kompilacja i uruchamianie testów, wtyczka JavaScript. -| cmake | ≥ 3.0 | *tak* | Kompilacja (możliwe jest użycie autotools, jednak CMake jest zalecany). -| pkg-config | | *tak* | Wykrywa zainstalowane biblioteki. -| libncursesw5-dev ^(2)^ | | *tak* | Interfejs ncurses. -| libcurl4-gnutls-dev | | *tak* | Transfer URL. -| zlib1g-dev | | *tak* | Kompresja pakietów we wtyczce relay (protokół weechat), wtyczka script. -| libgcrypt20-dev | | *tak* | Zabezpieczone dane, uwierzytelnianie IRC SASL (DH-BLOWFISH/DH-AES). -| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | *tak* | Połączenia SSL z serwerami IRC, wsparcie dla SSL we wtyczce relay, uwierzytelnianie IRC SASL (ECDSA-NIST256P-CHALLENGE). -| gettext | | | Internacjonalizacja (tłumaczenie wiadomości; język bazowy to Angielski). -| ca-certificates | | | Certyfikaty dla połączeń SSL. -| libaspell-dev - ∥ libenchant-dev | | | Wtyczka spell. -| python3-dev | ^(4)^ | | Wtyczka python. -| libperl-dev | | | Wtyczka perl. -| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | | Wtyczka ruby. -| liblua5.3-dev | | | Wtyczka lua. -| tcl-dev | ≥ 8.5 | | Wtyczka tcl. -| guile-2.0-dev | ≥ 2.0 | | Wtyczka guile (scheme). -| libv8-dev | ≤ 3.24.3 | | Wtyczka javascript. -| php-dev, libphp-embed | ≥ 7.0 | | Wtyczka PHP. -| libxml2-dev | | | Wtyczka PHP. -| libargon2-0-dev | | | Wtyczka PHP (jeśli PHP ≥ 7.2). -| libsodium-dev | | | Wtyczka PHP (jeśli PHP ≥ 7.2). -| asciidoctor | ≥ 1.5.4 | | Tworzenie strony man i dokumentacji. -| libcpputest-dev | ≥ 3.4 | | Kompilacja i uruchamianie testów. + (gcc, clang, ...) | | Kompilacja. +| cmake | ≥ 3.0 | Kompilacja (możliwe jest użycie autotools, jednak CMake jest zalecany). +| pkg-config | | Wykrywa zainstalowane biblioteki. +| libncursesw5-dev ^(2)^ | | Interfejs ncurses. +| libcurl4-gnutls-dev | | Transfer URL. +| zlib1g-dev | | Kompresja pakietów we wtyczce relay (protokół weechat), wtyczka script. +| libgcrypt20-dev | | Zabezpieczone dane, uwierzytelnianie IRC SASL (DH-BLOWFISH/DH-AES). +| libgnutls28-dev | ≥ 2.2.0 ^(3)^ | Połączenia SSL z serwerami IRC, wsparcie dla SSL we wtyczce relay, uwierzytelnianie IRC SASL (ECDSA-NIST256P-CHALLENGE). |=== [NOTE] @@ -137,8 +120,36 @@ mogą być inne w innych dystrybucjach. + WeeChat można skompilowac używając libncurses5-dev, ale *NIE* jest to zalecane: możesz doświadczyć błędów wyświetlania. + ^(3)^ GnuTLS ≥ 3.0.21 jest wymagany dla uwierzytelnienia IRC SASL za pomocą -mechanizmu ECDSA-NIST256P-CHALLENGE. + -^(4)^ Domyślnie używany jest Pythin 3.x. Chyba że włączysz opcję `+ENABLE_PYTHON2+` +mechanizmu ECDSA-NIST256P-CHALLENGE. + +The following table shows the list of packages that are optional to compile +WeeChat: + +[width="100%",cols="5,^3,.^15",options="header"] +|=== +| Pakiet | Wersja | Opis +| kompilator C++ | | Kompilacja i uruchamianie testów, wtyczka JavaScript. +| gettext | | Internacjonalizacja (tłumaczenie wiadomości; język bazowy to Angielski). +| ca-certificates | | Certyfikaty dla połączeń SSL. +| libaspell-dev + ∥ libenchant-dev | | Wtyczka spell. +| python3-dev ^(1)^ | | Wtyczka python. +| libperl-dev | | Wtyczka perl. +| ruby2.5, ruby2.5-dev | ≥ 1.9.1 | Wtyczka ruby. +| liblua5.3-dev | | Wtyczka lua. +| tcl-dev | ≥ 8.5 | Wtyczka tcl. +| guile-2.0-dev | ≥ 2.0 | Wtyczka guile (scheme). +| libv8-dev | ≤ 3.24.3 | Wtyczka javascript. +| php-dev, libphp-embed | ≥ 7.0 | Wtyczka PHP. +| libxml2-dev | | Wtyczka PHP. +| libargon2-0-dev | | Wtyczka PHP (jeśli PHP ≥ 7.2). +| libsodium-dev | | Wtyczka PHP (jeśli PHP ≥ 7.2). +| asciidoctor | ≥ 1.5.4 | Tworzenie strony man i dokumentacji. +| libcpputest-dev | ≥ 3.4 | Kompilacja i uruchamianie testów. +|=== + +[NOTE] +^(1)^ Domyślnie używany jest Pythin 3.x. Chyba że włączysz opcję `+ENABLE_PYTHON2+` (zobacz niżej), zaleca się uzywania wersji 2.7 Pythona. Jeśli używasz dystrybujci bazującej na Debianie/Ubuntu, oraz jeśli posiadasz wpisy