doc/dev: add arrow and open external links in new tab

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