跳轉到內容

新增附錄（實驗軟體）

Edit links
來自華夏公益教科書

建立者：User:Goelette_Cardabela 於 2022年3月24日為華夏公益教科書建立
維基手冊，另請參見： 法語 Add_appendix 維基手冊
上次更新：2022/03/30

Add_appendix 軟體
描述手冊

修訂：2022年3月25日

描述

[編輯 | 編輯原始碼]
附錄 (VO)、附件、add_appendix/annexer (VI)、addappendix 軟體為華夏公益教科書中的書籍建立附錄頁面。
所有版本的要求：必須安裝mkd[1]。

版本

[編輯 | 編輯原始碼]
  • 詞彙表
    (VO)：法語原始版本。
    (VI)：國際化版本。
    編譯後的書籍：透過“建立合集”選單獲得的文章合集，用於使用PediaPress列印或使用addappendix建立書籍附錄。


  1. annexer (VO) 是此附錄頁面建立者軟體系列的原始版本

annex, add_appendix, addappendix。可執行指令碼的訊息為法語，按以下順序執行：lister、télécharger、ajouter_sclt、ajouter_sclic、ajouter_sclip.inc、sclipwb、sclipco 或全域性：annexer
因此，可以根據“用於學習 bash 程式設計的指令”[2]逐步控制附錄頁面的構建。
- 注意 - 卡達貝拉帆船的書籍和小冊子的附錄頁面[3]是用 2020 年 6 月的這個版本製作的。

  1. annex 遵循annexer (VO)版本。此國際化版本可用於所有語言。訊息的原始語言為英語，因為對於使用gettext進行國際化來說，它應該是英語。指令碼依次執行並分別翻譯。
  2. add_appendix/annexer (VI) 是annex之後的最終版本。它由annex版本的基檔案組成，我們向其中添加了兩個指令碼，旨在簡化包含程式annex（它是該程式的一個元件）執行所需檔案的書籍目錄的建立。同樣，指令碼依次執行，從pre-annex開始
    Makefile add_appendix.mak 便於將此版本安裝到使用者目錄 ~/Add_appendix 中
  3. addappendix 是用於在 Linux 上輕鬆安裝的打包版本。Ubuntu 包可以轉換為其他系統，如fedora、red hat等。
    Makefile addappendix.mak 便於將此版本安裝到使用者目錄 ~/Add_appendix 和 /usr/local 系統中，而無需透過包進行安裝。
每個軟體的特性:
  • annexer (VO) 簡單，僅用法語。
  • annex 需要手動操作來建立書籍目錄並將書籍內容複製到其中。您可以使用pre-annex建立書籍目錄的內容。
  • add_appendix/annexer (VI) 建立書籍的目錄並將程式執行所需的檔案複製到其中，它考慮了摘要、目錄、合集。
  • addapendix 建立程式執行條件並僅使用編譯後的書籍的 URL 執行參見詞彙表

annexer (VO)

[編輯 | 編輯原始碼]
參考頁面：Annexer (Version_orignale)[4]
修訂日期01/07/2020
語言：法語
下載：是[5]
手動安裝：可能（簡單）：將指令碼從華夏公益教科書複製到 ~/Annexer 目錄中的檔案
傳統 Linux 手冊：法語。'annexer_fr.1'
用法：annexer < BookName | ? > [ -v ] [ -pb | -pc ]
選項
?：幫助
-v：詳細模式
-pb：在法語華夏公益教科書中搜索書籍的圖片。
-pc：在共享資源庫中搜索圖片
示例：LivreTest
  1. 開啟終端並驗證 mkd軟體是否存在；（man mkd 或 mkd \?)
  2. 建立目錄 ~/Annexer/LivreTest。
  3. 進入 Annexer 目錄。
  4. 編輯https://fr.wikibooks.org/wiki/Utilisateur:Goelette_Cardabela/Sandbox/LivreTest/contenu
  5. 將編輯的部分複製到~/Annexer/LivreTest/LivreTest.contenu
  6. 執行./annexer LivreTest
  7. 與./annexer LivreTest -pb 和./annexer LivreTest -pc進行比較
- 注意：- 要整合書籍根目錄的圖片，您可以在LivreTest.contenu檔案的開頭新增書籍的地址
; Article maître du livre
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest|LivreTest]]
; Contenus
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleUn|ArticleUn]]<br />
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleDeux|ArticleDeux]]<br />
[[Utilisateur:Goelette Cardabela/Sandbox/LivreTest/ArticleTrois|ArticleTrois]]
請注意，附錄軟體僅識別https://fr.wikibooks.org站點，我們不會查詢書籍來源站點的名稱。

annex

[編輯 | 編輯原始碼]
參考頁面：軟體開發[6]
修訂日期04/10/2021
語言：英語、法語
下載：否。您可以將指令碼從華夏公益教科書複製到 ~/Add_appendix/src/Add_appendix 目錄中的檔案(.sh)
手動安裝：是或使用包含annex的 add_appendix.mak
傳統 Linux 手冊：英語 annex_en.1，法語 annex_fr.1
用法：annex < BookName | ? > [ -v ] [ -pb | -pc ]
選項
?：幫助
-v：詳細模式
-pb：在華夏公益教科書網站上查詢圖片。
-pc：在維基共享資源網站上查詢圖片
示例：Project TestBook

自 2021 年 5 月起，我們使用 pre-annex 配置書籍目錄

pre-annex.sh 頭部文件
#H Workdir is ~/Add_appendix or ~/Annexer
#H Executable file : Workdir/bin/pre-annex
#H Syntax : pre-annex <Full-url-of-book >
程式 pre-annex 的文件
#F Ce programme pré-annexe la construction de l'annexe du livre
#F Si ce programme s'est bien exécuté, le répertoire de projet aura été créé
#F - le fichier projet.suffixe et un fichier html local auront été créés dans
#F - le répertoire du projet
#F Il est proposé d'éditer la page 'Contenu' ou 'Sommaire' ou de 'Compilation'
#F   afin d'être éventuellement recopiée manuellement dans le fichier 
#F   projet.suffixe
  1. 開啟終端
  2. 進入 ~/Add_appendix 目錄
  3. 執行 bin/pre-annex https://wikibook.tw/wiki/User:Goelette_Cardabela/Sandbox/TestBook
  4. 執行bin/annex TestBook
  5. 與bin/annex TestBook -pb 和bin/annex TestBook -pc進行比較
- 注意：- 要整合書籍根目錄的圖片，請檢查書籍的地址是否在Add_appendix/books/TestBook/TestBook.contents中。

add_appendix/annexer (VI)

[編輯 | 編輯原始碼]
參考頁面：軟體開發[6]
修訂日期04/03/2022
語言：英語、法語
下載：否。請參見https://wikibook.tw/wiki/User:Goelette_Cardabela/Sandbox/Add_appendix。您可以將指令碼從華夏公益教科書複製到 ~/Add_appendix/src/Add_appendix 目錄中的檔案(.sh)
手動安裝：是，使用 add_appendix.mak
傳統 Linux 手冊：{{{1}}}，{{{1}}}。
用法：add_appendix < 書籍的完整 URL | ? > [ -v ] [ -pb | -pc ]
或 annexer < 書籍的完整 URL | ? > [ -v ] [ -pb | -pc ]
選項
?：幫助
-v：詳細模式
-pb：在法語華夏公益教科書中搜索書籍的圖片。
-pc：在共享資源庫中搜索圖片
示例 1：專案TestBook。將執行的便捷性與先前使用annex (VO)和annex的示例進行比較
  1. 開啟終端
  2. 進入可執行檔案目錄 (Bindir) ~/Annexer/bin 或 ~/Add_appendix/bin
  3. 執行 ./add_appendix https://wikibook.tw/wiki/User:Goelette_Cardabela/Sandbox/TestBook/Content
  4. 建立書籍的目錄結構，您可以在 bin 目錄中執行：./annex TestBook -pb 和./annex TestBook -pc，並比較結果。
- 注意：- 要整合書籍根目錄的圖片，您可以在LivreTest.content檔案的開頭新增書籍的地址
示例 2：專案船舶推進螺旋槳
Bindir = 目錄 ~/Annexer/bin 或 ~/Add_appendix/bin
執行Bindir/annexer https://fr.wikibooks.org/wiki/Hélices_de_navires_à_déplacement/Sommaire
- 注意：- 如果可執行檔案位於 /usr/local/bin 中，則無需指定 Bindir

addapendix

[編輯 | 編輯原始碼]

截至 2022 年 3 月 28 日，addappendix 軟體尚未完全測試。

參考頁面：addappendix[7]
修訂日期：jj/mm/2022
語言：英語、法語
下載：--> 2022 年 4 月或 5 月的 Ubuntu 包
用法：addappendix < 編譯書籍的完整 URL | ? > [ --v ]
選項
?：幫助
--v：addappendix 版本
示例：製作自己的鹽花 編譯
  1. 開啟終端
  2. 執行以下命令：addappendix https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel
- 注意：-
addappendix 命令位於 /usr/local/bin 目錄下。
工作目錄為 ~/Add_apendix
執行上述命令後，書籍目錄將為 ~/Add_apendix/books/Faire_sa_fleur_de_sel

另請參閱

[編輯 | 編輯原始碼]

Add_appendix 目錄

[編輯 | 編輯原始碼]
add_appendix 目錄結構[8]

手冊

[編輯 | 編輯原始碼]

用法
如果已安裝手冊，則使用 'man man1 manuel'，否則使用 'nroff -man manuel.1 | less'。

'nroff -man manuel.1 | col -b > manuel.txt'（用於校對拼寫的手冊文字）
'nroff -man -Tps manuel.1 > manuel.ps'（Postscript 或 PDF）
'man2html manuel.1 > manuel.html'

通用

如果已安裝手冊，則可以以環境宣告的語言（echo $LANG）顯示，否則以英文顯示。

man1: 2022年3月26日：綠色表示正在進行中，藍色表示正在審查中，橙色表示正在建立中

  • 使用者手冊
bin: annexer，annex，add_appendix，addappendix，header.inc，lister，télécharger，ajouter_sclt，ajouter_sclic，ajouter_sclip.inc，sclipwb。
sbin: compil2bin，docu2html，htmlman，install_datasfiles，textman，updt-manuals，userman，users_install_annex

man3

  • 子程式，庫函式。
lib: findbook，cpcleaned2bin.sh，ecfpc.sh，killalldoc.sh

man7

  • 其他，包，約定等。
Makefiles: add_appedix，addapendix
Packages: addappendix

語言

[編輯 | 編輯原始碼]

目錄：Add_appendix/share/resources/lang/po

英文參考檔案（.pot）：add_appendix.pot，add_sclic.pot，add_sclipco.pot，add_sclipwb.pot，add_sclt.pot，annexer.pot，annex.pot，en_sclic.inc.pot，en_sclipco.inc.pot，en_sclt.inc.pot，header.inc.pot，list.pot，pre-annex.pot，scli.inc.pot

目錄：Add_appendix/share/resources/lang/po/fr

法語翻譯檔案（.po）：add_sclic.po，add_sclipco.po，add_sclipwb.po，add_sclt.po，annexer.po，annex.po，en_sclic.inc.po，en_sclipco.inc.po，en_sclipwb.inc.po，en_sclt.inc.po，fr_FR_addappendix.po，header.inc.po，scli.inc.po
已翻譯成法語的檔案（.mo）：addappendix.mo，add_sclic.mo，add_sclipco.mo，add_sclipwb.mo，add_sclt.mo，annexer.mo，annex.mo，en_sclic.inc.mo，en_sclipco.inc.mo，en_sclipwb.inc.mo，en_sclt.inc.mo，fr_FR_addappendix.mo，header.inc.mo，scli.inc.mo

已翻譯檔案 .mo 的目錄。

  • 目錄：Add_appendix/share/locale/fr/LC_MESSAGES，用於已翻譯成法語的使用者檔案，對於可執行檔案頭中的 TEXTDOMAINDIR="~/Add_appendix/share/locale"。
  • 目錄：/usr/share/locale/fr/LC_MESSAGES，用於已翻譯成法語的所有使用者的檔案，對於可執行檔案頭中的 TEXTDOMAINDIR="/usr/share/locale"。

文件

[編輯 | 編輯原始碼]

位於目錄：Add_appendix/share/doc/Add_appendix，usr/local/share/doc/Add_apendix，/usr/share/doc/addappendix

版權
自述檔案

以及更多

參考文獻

[編輯 | 編輯原始碼]
  1. ↑ https://en.wikipedia.org/wiki/mkd_(software)
  2. ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer
  3. ↑ https://fr.wikibooks.org/wiki/Goélette_Cardabela
  4. ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/Annexer_(Version_orignale)
  5. ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Auto-référencer/télécharger_par_ftp
  6. ↑ a b https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#Développement_du_logiciel
  7. ↑ https://fr.wikibooks.org/wiki/addappendix
  8. ↑ https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Structure_du_répertoire_Add_appendix
檢索自“https://wikibook.tw/w/index.php?title=Add_appendix_(experimental_software)&oldid=4413707”
華夏公益教科書