1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-27 05:16:38 +02:00

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

This commit is contained in:
Sébastien Helleu
2022-06-26 22:41:56 +02:00
parent aee4d283c9
commit 0fe3661eab
4 changed files with 71 additions and 61 deletions
+16 -16
View File
@@ -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
+16 -16
View File
@@ -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
+19 -16
View File
@@ -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
+20 -13
View File
@@ -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