Auto-éditer un wikilivre/Annexer (Version internationalisée)/manuels/annex.1

.../sbin/manuals/annex.1

This manual is the standard manual by default if the manual is not found in the user lang.

.\"Created with GNOME Manpages Editor Wizard
.\"http://sourceforge.net/projects/gmanedit2
.\"Initial created page by wikibooks user Goelette Cardabela
.TH annex 1 "August 30, 2021" "" "annex"

.SH NAME
annex \- program to create wkibooks Appendix page

.SH SYNOPSIS
.B annex < bookname >
.RI [ ? ] [ -v ] [ -pb | -pc ]
.br

.SH CONFIGURATION
Application directories must be created by the 
.I
users_install_annex.sh  
shell script
.br
The mkd software: \fIhttps://en.wikipedia.org/wiki/Mkd_(software)\fP  must be installed
.br
The directory of the book must be created and must contain the wikicodes of the compilation or the summary or the content of the book. This work can be simplified with the  shell command 
.I pre-annex <full-url> 
of book  or compilation.

.SH DESCRIPTION
This manual page explains the
.B annex
program. This program allows you to create the Appendix pages of Wikibooks books.
.PP
\fBannex\fP is created for users of wikibooks who wish to print their books by means of their own

.SH OPTIONS
.B
.IP   ?
This option print the syntax of the command
.B
.IP -v
Verbose mode
.TP
\fB-pb\fR
Creates a custom version of the images with data from the Mediawiki \fIWikibooks \fP server.
.TP
\fB-pb\fR
Creates a custom version of the images with data from the Mediawiki \fICommons \fP server.

.SH "EXIT STATUS"
The application normally returns the value 0 and a different value in case of errors.

.SH ERRORS
The most common errors can be caused by command line capacity overflows. It may be interesting, exceptionally, to create a page at the root of the server and create a redirect to a longer page, in order to unblock the command line. It would be better to rename the name of the too long page to the root of the Wikibooks site with a shorter name.

.SH ENVIRONMENT
This software was created in a linux environment. However the program can be run under widows 10 with mingw

.SH FILES
There are many files whose versions can change when improvements are desired. Refer to this French pages: 
.I
https://fr.wikibooks.org/w/index.php?title=Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)

.SH VERSIONS
The versions are noted YYMMDD - YY for year, MM for month, DD for day, of the last modification.

.SH HISTORY
2020 - History begins with home confinement due to the COVID-19 virus:
.I
https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre.
.br
2021 - Internationalization of codes and messages with the Add_appendix version

.SH DOWNLOAD
.I
https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)#src.orig_en_français

.SH AUTHORS
The first manual was created by the wikibooks user Goelette Cardabela and modified by ...

.SH NOTES
The current version 210828 of Add_appendix is ​​a beta version.

.SH BUGS
It is possible to create a discussion on the whole project and for each article of this software on the wikibooks pages, just connect to the wikibooks:
.I
https://fr.wikibooks.org/wiki/Auto-éditer_un_wikilivre/Annexer_(Version_internationalisée)
and to consult the discussion page of the article concerned.

.SH EXAMPLE
Execute in Add_appendix/bin  directory:
.TP
.ADL
.I
"./pre-annex.sh https://en.wikibooks.org/wiki/Wikibooks:Collections/Guide_to_Unix"
.TP 
"./annex Guide_to_unix -pb"
.TP
and see the file "Guide_to_Unix.appendix"
.TP
.TP
Execute:
.TP
.ADL
"./pre-annex.sh https://fr.wikibooks.org/wiki/Wikilivres:Compilations/Faire_sa_fleur_de_sel"
.TP 
"./annex Faire_sa_fleur_de_sel -pb"
.TP
and see the file "Faire_sa_fleur_de_sel.appendix"

.SH "SEE ALSO"
.I
https://fr.wikibooks.org/wiki/Goélette_Cardabela/Référencement_manuel