跳转到内容

添加附录（实验软件）

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://wikibooks.cn/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://wikibooks.cn/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://wikibooks.cn/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://wikibooks.cn/w/index.php?title=Add_appendix_(experimental_software)&oldid=4413707”
华夏公益教科书