summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSébastien Helleu <flashcode@flashtux.org>2022-06-26 22:41:56 +0200
committerSébastien Helleu <flashcode@flashtux.org>2022-06-26 22:41:56 +0200
commit0fe3661eab796c78cbbc5097634b68ecffd9a8e2 (patch)
tree19906670cb258f14cf1981ffe183763d85d12ae1 /doc
parentaee4d283c932e26ece83a8a69ebc95908c9c0281 (diff)
downloadweechat-0fe3661eab796c78cbbc5097634b68ecffd9a8e2.zip
doc/dev: add arrow and open external links in new tab
Diffstat (limited to 'doc')
-rw-r--r--doc/en/weechat_dev.en.adoc32
-rw-r--r--doc/fr/weechat_dev.fr.adoc32
-rw-r--r--doc/ja/weechat_dev.ja.adoc35
-rw-r--r--doc/sr/weechat_dev.sr.adoc33
4 files changed, 71 insertions, 61 deletions
diff --git a/doc/en/weechat_dev.en.adoc b/doc/en/weechat_dev.en.adoc
index 533db61d0..eca76f60e 100644
--- a/doc/en/weechat_dev.en.adoc
+++ b/doc/en/weechat_dev.en.adoc
@@ -10,8 +10,8 @@
This manual documents WeeChat chat client, it is part of WeeChat.
-Latest version of this document can be found on this page:
-https://weechat.org/doc/
+Latest version of this document can be found on
+https://weechat.org/doc/[this page ^↗^,window=_blank].
[[introduction]]
@@ -31,8 +31,8 @@ This manual documents WeeChat internals:
[[repositories]]
== Repositories
-WeeChat repositories are on GitHub organization "weechat":
-https://github.com/weechat
+WeeChat repositories are on GitHub organization
+https://github.com/weechat[weechat ^↗^,window=_blank].
List of repositories:
@@ -43,7 +43,7 @@ scripts::
the _official_ scripts submitted on weechat.org
weechat.org::
- source of WeeChat website: https://weechat.org/
+ source of https://weechat.org/[WeeChat website ^↗^,window=_blank]
weercd::
IRC testing server
@@ -468,13 +468,13 @@ Documentation files:
|    docgen.py | Python script to build auto-generated files in _includes/_ directory (see below).
|    XX/ | Documentation for language XX (languages: en, fr, de, it, ...).
|       weechat.1.XX.adoc | Man page (`man weechat`).
-|       weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide] (this document).
-|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ].
-|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference].
-|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide].
-|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol] (for remote interfaces).
-|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide].
-|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide].
+|       weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide ^↗^,window=_blank] (this document).
+|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^,window=_blank].
+|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^,window=_blank].
+|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank].
+|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^,window=_blank] (for remote interfaces).
+|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^,window=_blank].
+|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^,window=_blank].
|       includes/ | Files included in documentation.
|          autogen_api_completions.XX.adoc | Auto-generated file for Plugin API reference: completions (do *NEVER* update manually!).
|          autogen_api_hdata.XX.adoc | Auto-generated file for Plugin API reference: hdata (do *NEVER* update manually!).
@@ -739,7 +739,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[[coding_python_style]]
=== Python style
-See https://www.python.org/dev/peps/pep-0008/
+See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
[[core_internals]]
== Core internals
@@ -1115,7 +1115,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
[[git_repository]]
=== Git repository
-Git repository is at this URL: https://github.com/weechat/weechat
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
@@ -1265,8 +1265,8 @@ $ make translations && make update-po
Then you can edit .po files (if you can translate in a language).
-When done, you *have* to check your file with script _msgcheck.py_
-(https://github.com/flashcode/msgcheck):
+When done, you *have* to check your file with
+https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
----
$ msgcheck.py xx.po
diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc
index 26e8a628a..e701250ec 100644
--- a/doc/fr/weechat_dev.fr.adoc
+++ b/doc/fr/weechat_dev.fr.adoc
@@ -12,8 +12,8 @@
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
-La dernière version de ce document peut être téléchargée sur cette page :
-https://weechat.org/doc/
+La dernière version de ce document peut être téléchargée sur
+https://weechat.org/doc/[cette page ^↗^,window=_blank].
[[introduction]]
@@ -33,8 +33,8 @@ Ce manuel documente l'intérieur de WeeChat :
[[repositories]]
== Dépôts
-Les dépôts de WeeChat sont dans l'organisation "weechat" de GitHub :
-https://github.com/weechat
+Les dépôts de WeeChat sont dans l'organisation
+https://github.com/weechat[weechat ^↗^,window=_blank] de GitHub.
Liste des dépôts :
@@ -45,7 +45,7 @@ scripts::
les scripts _officiels_ soumis sur weechat.org
weechat.org::
- le code source du site de WeeChat : https://weechat.org/
+ le code source du https://weechat.org/[site de WeeChat ^↗^,window=_blank]
weercd::
serveur de test IRC
@@ -470,13 +470,13 @@ Fichiers de documentation :
|    docgen.py | Script Python pour construire les fichiers auto-générés dans le répertoire _includes/_ (voir ci-dessous).
|    XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...).
|       weechat.1.XX.adoc | Page de manuel (`man weechat`).
-|       weechat_dev.XX.adoc | link:weechat_dev.fr.html[Guide du développeur] (ce document).
-|       weechat_faq.XX.adoc | link:weechat_faq.fr.html[FAQ] (questions fréquemment posées).
-|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.fr.html[Référence API extension].
-|       weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage].
-|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay (pour les interfaces distantes)].
-|       weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts].
-|       weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur].
+|       weechat_dev.XX.adoc | link:weechat_dev.fr.html[Guide du développeur ^↗^,window=_blank] (ce document).
+|       weechat_faq.XX.adoc | link:weechat_faq.fr.html[FAQ ^↗^,window=_blank] (questions fréquemment posées).
+|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.fr.html[Référence API extension ^↗^,window=_blank].
+|       weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage ^↗^,window=_blank].
+|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay ^↗^,window=_blank] (pour les interfaces distantes).
+|       weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts ^↗^,window=_blank].
+|       weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur ^↗^,window=_blank].
|       includes/ | Fichiers inclus dans la documentation.
|          autogen_api_completions.XX.adoc | Fichier auto-généré pour la Référence API extension : complétions (ne *JAMAIS* mettre à jour manuellement !).
|          autogen_api_hdata.XX.adoc | Fichier auto-généré pour la Référence API extension : hdata (ne *JAMAIS* mettre à jour manuellement !).
@@ -750,7 +750,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[[coding_python_style]]
=== Style Python
-Voir https://www.python.org/dev/peps/pep-0008/
+Voir https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
[[core_internals]]
== Intérieur du cœur
@@ -1134,7 +1134,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
[[git_repository]]
=== Dépôt Git
-Le dépôt Git est à cette URL : https://github.com/weechat/weechat
+Le dépôt Git est sur https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la
branche master, le format préféré étant une "pull request" sur GitHub. Un patch
@@ -1286,8 +1286,8 @@ $ make translations && make update-po
Vous pouvez alors éditer les fichiers .po (si vous pouvez traduire dans une
langue).
-Une fois terminé, vous *devez* vérifier votre fichier avec le script
-_msgcheck.py_ (https://github.com/flashcode/msgcheck) :
+Une fois terminé, vous *devez* vérifier votre fichier avec
+https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank] :
----
$ msgcheck.py xx.po
diff --git a/doc/ja/weechat_dev.ja.adoc b/doc/ja/weechat_dev.ja.adoc
index 27c3e6d49..81cdc4058 100644
--- a/doc/ja/weechat_dev.ja.adoc
+++ b/doc/ja/weechat_dev.ja.adoc
@@ -16,8 +16,9 @@
このマニュアルは WeeChat チャットクライアントについての文書で、これは WeeChat の一部です。
-この文書の最新版は以下のページにあります:
-https://weechat.org/doc/
+// TRANSLATION MISSING
+Latest version of this document can be found on
+https://weechat.org/doc/[this page ^↗^,window=_blank].
[[introduction]]
@@ -37,8 +38,7 @@ WeeChat (Wee Enhanced Environment for Chat)
[[repositories]]
== リポジトリ
-WeeChat リポジトリは GitHub organization の "weechat" にあります:
-https://github.com/weechat
+WeeChat リポジトリは GitHub organization の https://github.com/weechat[weechat ^↗^,window=_blank] にあります:
リポジトリのリスト:
@@ -48,8 +48,9 @@ weechat::
scripts::
weechat.org に投稿された _公式_ スクリプト
+// TRANSLATION MISSING
weechat.org::
- WeeChat ウェブサイトのソースコード: https://weechat.org/
+ source of https://weechat.org/[WeeChat website ^↗^,window=_blank]
weercd::
IRC テストサーバ
@@ -521,13 +522,13 @@ WeeChat "core" は以下のディレクトリに配置されています:
|    docgen.py | Python script to build auto-generated files in _includes/_ directory (see below).
|    XX/ | 言語コード XX (言語コード: en、fr、de、it、...) 用のディレクトリ
|       weechat.1.XX.adoc | man ページ (`man weechat`)
-|       weechat_dev.XX.adoc | link:weechat_dev.ja.html[開発者リファレンス] (この文書)
-|       weechat_faq.XX.adoc | link:weechat_faq.ja.html[FAQ]
-|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.ja.html[プラグイン API リファレンス]
-|       weechat_quickstart.XX.adoc | link:weechat_quickstart.ja.html[クイックスタートガイド]
-|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.ja.html[リレープロトコル] (リモートインターフェース用)
-|       weechat_scripting.XX.adoc | link:weechat_scripting.ja.html[スクリプト作成ガイド]
-|       weechat_user.XX.adoc | link:weechat_user.ja.html[ユーザーズガイド]
+|       weechat_dev.XX.adoc | link:weechat_dev.ja.html[開発者リファレンス ^↗^,window=_blank] (この文書)
+|       weechat_faq.XX.adoc | link:weechat_faq.ja.html[FAQ ^↗^,window=_blank]
+|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.ja.html[プラグイン API リファレンス ^↗^,window=_blank]
+|       weechat_quickstart.XX.adoc | link:weechat_quickstart.ja.html[クイックスタートガイド ^↗^,window=_blank]
+|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.ja.html[リレープロトコル ^↗^,window=_blank] (リモートインターフェース用)
+|       weechat_scripting.XX.adoc | link:weechat_scripting.ja.html[スクリプト作成ガイド ^↗^,window=_blank]
+|       weechat_user.XX.adoc | link:weechat_user.ja.html[ユーザーズガイド ^↗^,window=_blank]
// TRANSLATION MISSING
|       includes/ | Files included in documentation.
|          autogen_api_completions.XX.adoc | Auto-generated file for Plugin API reference: completions (do *NEVER* update manually!).
@@ -791,7 +792,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[[coding_python_style]]
=== Python スタイル
-https://www.python.org/dev/peps/pep-0008/ を参照
+https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank] を参照
[[core_internals]]
== コアの構造
@@ -1175,7 +1176,8 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
[[git_repository]]
=== Git リポジトリ
-Git リポジトリはこの URL にあります: https://github.com/weechat/weechat
+// TRANSLATION MISSING
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
バグや新機能のパッチは必ず master ブランチに対して適用できるものを作成し、GitHub の pull
リクエストを使って提出することを推奨します。パッチは電子メールで送信することも可能です
@@ -1342,8 +1344,9 @@ $ make translations && make update-po
その後翻訳できるならば .po ファイルを編集します。
-翻訳が完了したら、*必ず* _msgcheck.py_ (https://github.com/flashcode/msgcheck)
-スクリプトを使ってファイルの内容を確認してください:
+// TRANSLATION MISSING
+When done, you *have* to check your file with
+https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
----
$ msgcheck.py xx.po
diff --git a/doc/sr/weechat_dev.sr.adoc b/doc/sr/weechat_dev.sr.adoc
index 88cd7d02a..f1f48afcb 100644
--- a/doc/sr/weechat_dev.sr.adoc
+++ b/doc/sr/weechat_dev.sr.adoc
@@ -15,7 +15,9 @@
Ово упутство описује WeeChat чет клијент и део је програма WeeChat.
-Последња верзија овог документа може да се нађе на следећој страници: https://weechat.org/doc/
+// TRANSLATION MISSING
+Latest version of this document can be found on
+https://weechat.org/doc/[this page ^↗^,window=_blank].
[[introduction]]
@@ -34,7 +36,8 @@ WeeChat (Wee Enhanced Environment for Chat) је бесплатни чет кл
[[repositories]]
== Репозиторијуми
-WeeChat репозиторијуми се налазе на GitHub организацији „weechat”: https://github.com/weechat
+WeeChat репозиторијуми се налазе на GitHub организацији
+https://github.com/weechat[weechat ^↗^,window=_blank].
Листа репозиторијума:
@@ -44,8 +47,9 @@ weechat::
scripts::
_званичне_ скрипте које су предате на weechat.org
+// TRANSLATION MISSING
weechat.org::
- извор WeeChat веб сајта: https://weechat.org/
+ source of https://weechat.org/[WeeChat website ^↗^,window=_blank]
weercd::
IRC сервер за тестирање
@@ -469,13 +473,13 @@ WeeChat „језгро” се налази у следећим директо
|    docgen.py | Python скрипта која изграђује ауто-генерисане фајлу у директоријуму _includes/_ (погледајте ниже).
|    XX/ | Документација за језик XX (језици: en, fr, de, it, ...).
|       weechat.1.XX.adoc | Man страница(`man weechat`).
-|       weechat_dev.XX.adoc | link:weechat_dev.sr.html[Водич за програмере] (овај документ).
-|       weechat_faq.XX.adoc | link:weechat_faq.sr.html[ЧПП].
-|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.sr.html[Референца за API додатака].
-|       weechat_quickstart.XX.adoc | link:weechat_quickstart.sr.html[Водич за брзи почетак].
-|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.sr.html[Релеј протокол] (за удаљене интерфејсе).
-|       weechat_scripting.XX.adoc | link:weechat_scripting.sr.html[Водич за скриптовање].
-|       weechat_user.XX.adoc | link:weechat_user.sr.html[Корисничко упутство].
+|       weechat_dev.XX.adoc | link:weechat_dev.sr.html[Водич за програмере ^↗^,window=_blank] (овај документ).
+|       weechat_faq.XX.adoc | link:weechat_faq.sr.html[ЧПП ^↗^,window=_blank].
+|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.sr.html[Референца за API додатака ^↗^,window=_blank].
+|       weechat_quickstart.XX.adoc | link:weechat_quickstart.sr.html[Водич за брзи почетак ^↗^,window=_blank].
+|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.sr.html[Релеј протокол ^↗^,window=_blank] (за удаљене интерфејсе).
+|       weechat_scripting.XX.adoc | link:weechat_scripting.sr.html[Водич за скриптовање ^↗^,window=_blank].
+|       weechat_user.XX.adoc | link:weechat_user.sr.html[Корисничко упутство ^↗^,window=_blank].
|       includes/ | Фајлови укључени у документацију.
|          autogen_api_completions.XX.adoc | Ауто-генерисани фајл за Референцу API додатака: довршавања (*НИКАДА* не ажурирајте ручно!).
|          autogen_api_hdata.XX.adoc | Ауто-генерисани фајл за Референцу API додатака: hdata (*НИКАДА* не ажурирајте ручно!).
@@ -730,7 +734,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
[[coding_python_style]]
=== Python стил
-Погледајте https://www.python.org/dev/peps/pep-0008/
+Погледајте https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
[[core_internals]]
== Интерне ствари језгра
@@ -1085,7 +1089,8 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
[[git_repository]]
=== Git репозиторијум
-Git репозиторијум се налази на следећој URL адреси: https://github.com/weechat/weechat
+// TRANSLATION MISSING
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
Било каква закрпа бага или нова могућност мора да да се уради над мастер граном, пожељно је преко GitHub pull захтева. Закрпа такође може да се пошаље и имејлом (направљена са `git diff` или `git format-patch`).
@@ -1228,7 +1233,9 @@ $ make translations && make update-po
Затим можете да уређујте .po фајлове (ако можете да преводите на језик).
-Када завршите, *морате* да проверите свој фајл скриптом _msgcheck.py_ (https://github.com/flashcode/msgcheck):
+// TRANSLATION MISSING
+When done, you *have* to check your file with
+https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
----
$ msgcheck.py xx.po