1
0
Fork 0

Make automatically generated documentation easier to translate

This commit is contained in:
Joris van der Hoeven 2020-10-08 15:17:23 +00:00
parent a992fa37bc
commit a48a810eae
4 changed files with 984 additions and 0 deletions

View File

@ -0,0 +1,414 @@
<TeXmacs|1.99.13>
<style|<tuple|tmdoc|automate>>
<\body>
<block-assign|<implied-scm|t>|<implied-scm|(focus-tree)>>
<block-assign|<implied-scm|tag>|<implied-scm|(tree-label t)>>
<block-assign|<implied-scm|n>|<implied-scm|(tree-arity t)>>
<block-assign|<implied-scm|nl>|<implied-scm|(focus-doc-arg-names t 0 '())>>
<block-assign|<implied-scm|tag-doc>|<implied-scm|(tmdoc-search-tag tag)>>
<tmdoc-title|Contextual help on the \P<output-string|<implied-scm|tag>>\Q
tag>
<\block-if-else|<implied-scm|tag-doc>>
<\unfolded-documentation|Description>
<block-output|<implied-scm|tag-doc>>
</unfolded-documentation>
<|block-if-else>
<\unfolded-documentation|Usage>
<\explain|<inline-output|<implied-scm|`(explain-macro
,(symbol-\<gtr\>string tag) ,@nl)>>>
<\block-texmacs-tag|description-aligned>
<\block-for|<implied-scm|i>|<implied-scm|(.. 0 n)>>
<inline-texmacs-tag|item*|<src-arg|<output-string|<implied-scm|(list-ref
nl i)>>>><inline-if-else|<implied-scm|(== (list-ref nl i)
"body")>|The main body of the macro.|An argument of type
\P<output-string|<implied-scm|(tree-child-type t i)>>\Q.>
</block-for>
</block-texmacs-tag>
</explain>
</unfolded-documentation>
</block-if-else>
<\block-if|<implied-scm|(tree-label-extension? tag)>>
<\unfolded-documentation|Current definition>
<\surround||<vspace|2fn>>
<\tm-fragment>
<inline-texmacs-tag|inactive*|<inline-texmacs-tag|assign|<output-string|<implied-scm|tag>>|<inline-output|<implied-scm|(get-env-tree
(symbol-\<gtr\>string tag))>>>>
</tm-fragment>
</surround>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(or (focus-has-variants? t) (focus-has-toggles?
t))>>
<\unfolded-documentation|Structured variants>
<\block-if|<implied-scm|(focus-has-variants? t)>>
The <markup|<output-string|<implied-scm|tag>>> tag has several
<help-link|structured variants|main/editing/man-structured-variants>:
<inline-intersperse|, |<inline-for|<implied-scm|v>|<implied-scm|(variants-of
tag)>|<markup|<output-string|<implied-scm|v>>>>>. You may circle
among these variants using the keyboard shortcuts
<shortcut|(variant-circulate (focus-tree) #t)> and
<shortcut|(variant-circulate (focus-tree) #f)>. You may also pick a
specific variant from the <menu|Focus|<output-string|<implied-scm|(focus-tag-name
tag)>>> menu or the <menu|<output-string|<implied-scm|(focus-tag-name
tag)>>> menu on the focus toolbar.
</block-if>
<\block-if|<implied-scm|(numbered-context? t)>>
For most style files, the <markup|<output-string|<implied-scm|tag>>>
environment is <inline-if-else|<implied-scm|(symbol-numbered?
tag)>|numbered|unnumbered>. The environment has
<inline-if-else|<implied-scm|(symbol-numbered? tag)>|an unnumbered|a
numbered> variant <markup|<output-string|<implied-scm|(symbol-toggle-number
tag)>>>. You may toggle the numbering using the keyboard shortcut
<shortcut|(numbered-toggle (focus-tree))>, the menu entry
<menu|Focus|Numbered>, or by pressing the <icon|tm_numbered.xpm> icon
on the focus toolbar.
</block-if>
<\block-if|<implied-scm|(alternate-context? t)>>
<\block-if|<implied-scm|(alternate-first? t)>>
The <markup|<output-string|<implied-scm|tag>>> environment is
\Pfolded\Q and has an unfolded variant
<markup|<output-string|<implied-scm|(symbol-toggle-alternate
tag)>>>. You may unfold the environment using the keyboard shortcut
<shortcut|(alternate-toggle (focus-tree))>, the menu entry
<menu|Focus|Folded>, or by pressing the
<icon|tm_alternate_first.xpm> icon on the focus toolbar.
</block-if>
<\block-if|<implied-scm|(alternate-second? t)>>
The <markup|<output-string|<implied-scm|tag>>> environment is
\Punfolded\Q and has a folded variant
<markup|<output-string|<implied-scm|(symbol-toggle-alternate
tag)>>>. You may fold the environment using the keyboard shortcut
<shortcut|(alternate-toggle (focus-tree))>, the menu entry
<menu|Focus|<output-string|<implied-scm|(alternate-second-name
t)>>>, or by pressing the <inline-texmacs-tag|icon|<output-string|<implied-scm|(alternate-second-icon
t)>>> icon on the focus toolbar.
</block-if>
Folding and unfolding is performed automatically during the traversal
of a document in <help-link|presentation
mode|main/beamer/man-beamer>.
</block-if>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-has-preferences? t)>>
<\unfolded-documentation|Style preferences>
<block-assign|<implied-scm|opts>|<implied-scm|(search-tag-options t)>>
<block-assign|<implied-scm|pars>|<\implied-scm>
(list-filter (search-tag-parameters t) parameter-show-in-menu?)
</implied-scm>>
<block-assign|<implied-scm|thms>|<\implied-scm>
(search-tag-themes t)
</implied-scm>>
The rendering of the <markup|<output-string|<implied-scm|tag>>> tag can
be customized by editing the macro which defines it. This can be done
by clicking on <menu|Edit macro> button in the <menu|Focus|Preferences>
menu (or in the equivalent <icon|tm_focus_prefs.xpm> icon menu on the
focus toolbar). You may also directly edit the macro in the style file
or package where it was defined, using <menu|Edit source>.
<\block-if|<implied-scm|(nnull? (append opts pars thms))>>
Still using the <menu|Focus|Preferences> menu, you may also specify
<inline-if|<implied-scm|(and (nnull? opts) (null? pars))>|style
options><inline-if|<implied-scm|(and (null? opts) (nnull?
pars))>|style parameters><inline-if|<implied-scm|(and (nnull? opts)
(nnull? pars))>|style options and parameters> that apply to the
<markup|<output-string|<implied-scm|tag>>> tag. These settings are
global, so they will apply to all other
<markup|<output-string|<implied-scm|tag>>> tags in your document, and
generally also to other similar tags.
</block-if>
<\block-if|<implied-scm|(nnull? thms)>>
The <markup|<output-string|<implied-scm|tag>>> tag uses themes for
its rendering. These themes come with their own style parameters that
can be customized via <menu|Focus|Preferences|Theme parameters>.
</block-if>
<\block-if|<implied-scm|(nnull? opts)>>
<\folded|<strong|Style options>>
<\block-for|<implied-scm|opt>|<implied-scm|opts>>
<block-assign|<implied-scm|opt-doc>|<\implied-scm>
(tmdoc-search-style opt)
</implied-scm>>
<block-assign|<implied-scm|sty-doc>|<\implied-scm>
(style-get-documentation opt)
</implied-scm>>
<\block-if-else|<implied-scm|opt-doc>>
<block-output|<implied-scm|opt-doc>>
<|block-if-else>
<\explain|<tmpackage|<output-string|<implied-scm|opt>>><explain-synopsis|<output-string|<implied-scm|(style-get-menu-name
opt)>>>>
<\block-if-else|<implied-scm|sty-doc>>
<inline-output|<implied-scm|sty-doc>>.
<|block-if-else>
Undocumented style package.
</block-if-else>
</explain>
</block-if-else>
</block-for>
</folded>
</block-if>
<\block-if|<implied-scm|(nnull? pars)>>
<\folded|<strong|Style parameters>>
<\block-for|<implied-scm|par>|<implied-scm|pars>>
<block-assign|<implied-scm|par-doc>|<\implied-scm>
(tmdoc-search-parameter par)
</implied-scm>>
<\block-if-else|<implied-scm|par-doc>>
<block-output|<implied-scm|par-doc>>
<|block-if-else>
<\explain|<src-var|<output-string|<implied-scm|par>>>>
A parameter of type <output-string|<implied-scm|(tree-label-type
(string-\<gtr\>symbol par))>>.
</explain>
</block-if-else>
</block-for>
</folded>
</block-if>
<\block-for|<implied-scm|thm>|<implied-scm|thms>>
<\folded|<strong|Parameters for the <output-string|<implied-scm|thm>>
theme>>
<\block-for|<implied-scm|par>|<implied-scm|(theme-\<gtr\>members
thm)>>
<block-assign|<implied-scm|par-doc>|<\implied-scm>
(tmdoc-search-parameter par)
</implied-scm>>
<\block-if-else|<implied-scm|par-doc>>
<block-output|<implied-scm|par-doc>>
<|block-if-else>
<\explain|<src-var|<output-string|<implied-scm|par>>>>
A parameter of type <output-string|<implied-scm|(tree-label-type
(string-\<gtr\>symbol par))>>.
</explain>
</block-if-else>
</block-for>
</folded>
</block-for>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-can-move? t)>>
<\unfolded-documentation|Structured navigation>
It is sometimes useful to quickly go through all
<markup|<output-string|<implied-scm|tag>>> tags and its variants,
\ inside a document. This can be done efficiently using the following
keyboard shortcuts, menu entries, or icons on the focus toolbar:\
<\description-long>
<item*|<shortcut|(kbd-select-if-active traverse-first)>,
<menu|Focus|First similar>, <icon|tm_similar_first.xpm>>Jump to the
first tag similar to <markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-previous)>,
<menu|Focus|Previous similar>, <icon|tm_similar_previous.xpm>>Jump to
the previous tag similar to <markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-next)>,
<menu|Focus|Next similar>, <icon|tm_similar_next.xpm>>Jump to the
next tag similar to <markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-last)>,
<menu|Focus|Last similar>, <icon|tm_similar_last.xpm>>Jump to the
last tag similar to <markup|<output-string|<implied-scm|tag>>>.
</description-long>
For more information and further useful shortcuts, we refer to the
section on <help-link|structured cursor
movements|main/editing/man-structured-move>.
</unfolded-documentation>
</block-if>
<\block-if-else|<implied-scm|(and (defined? 'any-table-tag?)
(any-table-tag? tag))>>
<\unfolded-documentation|Structured insert and delete>
The <markup|<output-string|<implied-scm|tag>>> tag is a tabular
environment. New rows and columns can be inserted using the following
keyboard shortcuts, menu entries, or icons on the focus toolbar:
<\description-long>
<item*|<shortcut|(structured-insert-left)>, <menu|Focus|Insert left>,
<icon|tm_insert_left.xpm>>Insert a new column on the left-hand side
of the cursor.
<item*|<shortcut|(structured-insert-right)>, <menu|Focus|Insert
right>, <icon|tm_insert_right.xpm>>Insert a new column on the
right-hand side of the cursor.
<item*|<shortcut|(structured-insert-up)>, <menu|Focus|Insert above>,
<icon|tm_insert_up.xpm>>Insert a new row above the cursor.
<item*|<shortcut|(structured-insert-down)>, <menu|Focus|Insert
below>, <icon|tm_insert_down.xpm>>Insert a new row below the cursor.
</description-long>
Existing rows and columns can be removed as follows:
<\description-long>
<item*|<shortcut|(structured-remove-left)>, <menu|Focus|Remove
leftwards>, <icon|tm_delete_left.xpm>>Remove the column at the
left-hand side of the cursor.
<item*|<shortcut|(structured-remove-right)>, <menu|Focus|Remove
rightwards>, <icon|tm_delete_right.xpm>>Remove the current column and
move to the next one.
<item*|<menu|Focus|Remove upwards>, <icon|tm_delete_up.xpm>>Remove
the row above the cursor.
<item*|<menu|Focus|Remove downwards>,
<icon|tm_delete_down.xpm>>Remove the current row and move to the one
below.
</description-long>
</unfolded-documentation>
<|block-if-else>
<\block-if-else|<implied-scm|(and (defined? 'field-tags) (tm-in? t
field-tags))>>
<\unfolded-documentation|Structured insert and delete>
The <markup|<output-string|<implied-scm|tag>>> tag is used inside
interactive sessions. New input fields can be inserted using the the
following keyboard shortcuts, menu entries, or icons on the focus
toolbar:
<\description-long>
<item*|<shortcut|(structured-insert-up)>, <menu|Focus|Insert field
above>, <icon|tm_insert_up.xpm>>Insert a new input field above the
cursor.
<item*|<shortcut|(structured-insert-down)>, <menu|Focus|Insert
field below>, <icon|tm_insert_down.xpm>>Insert a new input field
below the cursor.
</description-long>
Existing input or input/output fields can be removed as follows:
<\description-long>
<item*|<menu|Focus|Remove field above>,
<icon|tm_delete_up.xpm>>Remove the field above the cursor.
<item*|<menu|Focus|Remove field below>,
<icon|tm_delete_down.xpm>>Remove the current field and move to the
one below.
<item*|<menu|Focus|Remove banner>>Remove the start-up banner of the
session.
<item*|<menu|Focus|Remove last field>>Remove the last field of the
session.
</description-long>
</unfolded-documentation>
<|block-if-else>
<\block-if|<implied-scm|(or (structured-horizontal? t)
(structured-vertical? t))>>
<\unfolded-documentation|Structured insert and delete>
The <markup|<output-string|<implied-scm|tag>>> tag has a variable
number of arguments. New arguments can be inserted using the
following keyboard shortcuts, menu entries, or icons on the focus
toolbar:
<\block-texmacs-tag|description-long>
<\block-if|<implied-scm|(structured-horizontal? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-insert-left)>,
<menu|Focus|Insert left>, <icon|tm_insert_left.xpm>>Insert a
new argument at the left-hand side of the cursor.
<inline-texmacs-tag|item*|<shortcut|(structured-insert-right)>,
<menu|Focus|Insert right>, <icon|tm_insert_right.xpm>>Insert a
new argument at the right-hand side of the cursor.
</block-if>
<\block-if|<implied-scm|(structured-vertical? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-insert-up)>,
<menu|Focus|Insert above>, <icon|tm_insert_up.xpm>>Insert a new
argument above the cursor.
<inline-texmacs-tag|item*|<shortcut|(structured-insert-down)>,
<menu|Focus|Insert below>, <icon|tm_insert_down.xpm>>Insert a
new argument below the cursor.
</block-if>
</block-texmacs-tag>
Existing arguments can be removed as follows:
<\block-texmacs-tag|description-long>
<\block-if|<implied-scm|(structured-horizontal? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-remove-left)>,
<menu|Focus|Remove leftwards>, <icon|tm_delete_left.xpm>>Remove
the argument at the left-hand side of the cursor.
<inline-texmacs-tag|item*|<shortcut|(structured-remove-right)>,
<menu|Focus|Remove rightwards>,
<icon|tm_delete_right.xpm>>Remove the current argument and move
to the next one.
</block-if>
<\block-if|<implied-scm|(structured-vertical? t)>>
<inline-texmacs-tag|item*|<menu|Focus|Remove upwards>,
<icon|tm_delete_up.xpm>>Remove the argument above the cursor.
<inline-texmacs-tag|item*|<menu|Focus|Remove downwards>,
<icon|tm_delete_down.xpm>>Remove the current argument and move
to the one below.
</block-if>
</block-texmacs-tag>
</unfolded-documentation>
</block-if>
</block-if-else>
</block-if-else>
<\block-if|<implied-scm|(\<less\> (length (tree-accessible-children t))
n)>>
<\unfolded-documentation|Hidden arguments>
<block-assign|<implied-scm|il>|<implied-scm|(list-filter (.. 0 (length
nl)) (lambda (i) (not (tree-accessible-child? t i))))>>
<block-assign|<implied-scm|sl>|<implied-scm|(map (lambda (i) (list-ref
nl i)) il)>>
When the <markup|<output-string|<implied-scm|tag>>> tag is
<help-link|activated|main/text/keyboard/man-dynamic>, the following
arguments are hidden: <inline-intersperse|,
|<inline-for|<implied-scm|x>|<implied-scm|sl>|<src-arg|<output-string|<implied-scm|x>>>>>.
In order to edit the hidden arguments, you should use <menu|Focus|Show
hidden> or push the <icon|tm_show_hidden.xpm> icon on the focus
toolbar. Deactivated tags can be reactivated by pressing
<shortcut|(kbd-return)>.
Non internal hidden arguments which contain string values can also be
edited directly in the text fields on the focus toolbar; no need to
deactivate the <markup|<output-string|<implied-scm|tag>>> tag in this
case.
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-has-geometry? t)>>
<\unfolded-documentation|Structured geometry>
Not yet documented.
</unfolded-documentation>
</block-if>
</body>
<initial|<\collection>
</collection>>

View File

@ -0,0 +1,425 @@
<TeXmacs|1.99.13>
<style|<tuple|tmdoc|automate|french>>
<\body>
<block-assign|<implied-scm|t>|<implied-scm|(focus-tree)>>
<block-assign|<implied-scm|tag>|<implied-scm|(tree-label t)>>
<block-assign|<implied-scm|n>|<implied-scm|(tree-arity t)>>
<block-assign|<implied-scm|nl>|<implied-scm|(focus-doc-arg-names t 0 '())>>
<block-assign|<implied-scm|tag-doc>|<implied-scm|(tmdoc-search-tag tag)>>
<tmdoc-title|Aide contextuelle sur la balise \S
<output-string|<implied-scm|tag>> \T>
<\block-if-else|<implied-scm|tag-doc>>
<\unfolded-documentation|Description>
<block-output|<implied-scm|tag-doc>>
</unfolded-documentation>
<|block-if-else>
<\unfolded-documentation|Usage>
<\explain|<inline-output|<implied-scm|`(explain-macro
,(symbol-\<gtr\>string tag) ,@nl)>>>
<\block-texmacs-tag|description-aligned>
<\block-for|<implied-scm|i>|<implied-scm|(.. 0 n)>>
<inline-texmacs-tag|item*|<src-arg|<output-string|<implied-scm|(list-ref
nl i)>>>><inline-if-else|<implied-scm|(== (list-ref nl i)
"body")>|Le corps principal de la macro.|Un argument de type
\P<output-string|<implied-scm|(tree-child-type t i)>>\Q.>
</block-for>
</block-texmacs-tag>
</explain>
</unfolded-documentation>
</block-if-else>
<\block-if|<implied-scm|(tree-label-extension? tag)>>
<\unfolded-documentation|Définition actuelle>
<\surround||<vspace|2fn>>
<\tm-fragment>
<inline-texmacs-tag|inactive*|<inline-texmacs-tag|assign|<output-string|<implied-scm|tag>>|<inline-output|<implied-scm|(get-env-tree
(symbol-\<gtr\>string tag))>>>>
</tm-fragment>
</surround>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(or (focus-has-variants? t) (focus-has-toggles?
t))>>
<\unfolded-documentation|Variantes structurées>
<\block-if|<implied-scm|(focus-has-variants? t)>>
La balise <markup|<output-string|<implied-scm|tag>>> admet plusieurs
<help-link|variantes structurées|main/editing/man-structured-variants>
: <inline-intersperse|, |<inline-for|<implied-scm|v>|<implied-scm|(variants-of
tag)>|<markup|<output-string|<implied-scm|v>>>>>. Vous pouvez faire
tourner ces variantes via les raccourcis clavier
<shortcut|(variant-circulate (focus-tree) #t)> et
<shortcut|(variant-circulate (focus-tree) #f)>. Vous pouvez aussi
sélectionner une variante spécifique dans le menu
<menu|Focus|<output-string|<implied-scm|(focus-tag-name tag)>>> ou
depuis le menu <menu|<output-string|<implied-scm|(focus-tag-name
tag)>>> sur la barre de focus.
</block-if>
<\block-if|<implied-scm|(numbered-context? t)>>
Pour la plupart de styles, l'environnement
<markup|<output-string|<implied-scm|tag>>>
<inline-if-else|<implied-scm|(symbol-numbered? tag)>|est
numéroté|n'est pas numéroté>. L'environment admet une variante
<inline-if-else|<implied-scm|(symbol-numbered? tag)>|non
numérotée|numérotée> <markup|<output-string|<implied-scm|(symbol-toggle-number
tag)>>>. Vous pouvez basculer la numérotation avec le raccourci
clavier <shortcut|(numbered-toggle (focus-tree))>, l'entrée de menu
<menu|Focus|Numbered>, où en cliquant sur l'icône
<icon|tm_numbered.xpm> sur la barre de focus.
</block-if>
<\block-if|<implied-scm|(alternate-context? t)>>
<\block-if|<implied-scm|(alternate-first? t)>>
L'environnement <markup|<output-string|<implied-scm|tag>>> est \S
plié \T et <markup|<output-string|<implied-scm|tag>>> admet la
variante dépliée <markup|<output-string|<implied-scm|(symbol-toggle-alternate
tag)>>>. Vous pouvez déplier l'environnement utilisant le raccourci
<shortcut|(alternate-toggle (focus-tree))>, l'entrée de menu
<menu|Focus|Folded>, ou en cliquant sur l'icône
<icon|tm_alternate_first.xpm> sur la barre de focus.
</block-if>
<\block-if|<implied-scm|(alternate-second? t)>>
L'environnement <markup|<output-string|<implied-scm|tag>>> est \S
déplié \T et <markup|<output-string|<implied-scm|tag>>> admet la
variante repliée <markup|<output-string|<implied-scm|(symbol-toggle-alternate
tag)>>>. Vous pouvez plier l'environnement utilisant le raccourci
<shortcut|(alternate-toggle (focus-tree))>, l'entrée de menu
<menu|Focus|<output-string|<implied-scm|(alternate-second-name
t)>>>, ou en cliquant sur l'icône
<inline-texmacs-tag|icon|<output-string|<implied-scm|(alternate-second-icon
t)>>> sur la barre de focus.
</block-if>
En traversant un document en <help-link|mode de
présentation|main/beamer/man-beamer>, des environnements pliables
sont pliés et dépliés automatiquement.
</block-if>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-has-preferences? t)>>
<\unfolded-documentation|Préférences de style>
<block-assign|<implied-scm|opts>|<implied-scm|(search-tag-options t)>>
<block-assign|<implied-scm|pars>|<\implied-scm>
(list-filter (search-tag-parameters t) parameter-show-in-menu?)
</implied-scm>>
<block-assign|<implied-scm|thms>|<\implied-scm>
(search-tag-themes t)
</implied-scm>>
La rendue de la balise <markup|<output-string|<implied-scm|tag>>> peut
être personnalisée en éditant la macro qui la définit. Pour ceci, il
suffit de cliquer sur l'entrée <menu|Edit macro> du menu
<menu|Focus|Preferences> menu (ou du menu sous l'icône
<icon|tm_focus_prefs.xpm> de la barre de focus). Vous pouvez aussi
éditer directement la macro dans le fichier de style où elle est
définie, utilisant <menu|Edit source>.
<\block-if|<implied-scm|(nnull? (append opts pars thms))>>
Toujours dans le menu <menu|Focus|Preferences> menu, il est possible
de spécifier <inline-if|<implied-scm|(and (nnull? opts) (null?
pars))>|des options de style><inline-if|<implied-scm|(and (null?
opts) (nnull? pars))>|des paramètres de
style><inline-if|<implied-scm|(and (nnull? opts) (nnull? pars))>|des
options et des paramètres de style> qui s'appliquent à la balise
<markup|<output-string|<implied-scm|tag>>>. Ces réglages sont
globaux, donc il s'appliquent à toutes les balises
<markup|<output-string|<implied-scm|tag>>> dans votre document, et
même à toutes les balises similaires.
</block-if>
<\block-if|<implied-scm|(nnull? thms)>>
La balise <markup|<output-string|<implied-scm|tag>>> utilise des
thèmes pour sa rendue. Ces thèmes viennent avec leurs propres
paramètres de style qui peuvent être personnalisés via
<menu|Focus|Preferences|Theme parameters>.
</block-if>
<\block-if|<implied-scm|(nnull? opts)>>
<\folded|<strong|Options de style>>
<\block-for|<implied-scm|opt>|<implied-scm|opts>>
<block-assign|<implied-scm|opt-doc>|<\implied-scm>
(tmdoc-search-style opt)
</implied-scm>>
<block-assign|<implied-scm|sty-doc>|<\implied-scm>
(style-get-documentation opt)
</implied-scm>>
<\block-if-else|<implied-scm|opt-doc>>
<block-output|<implied-scm|opt-doc>>
<|block-if-else>
<\explain|<tmpackage|<output-string|<implied-scm|opt>>><explain-synopsis|<output-string|<implied-scm|(style-get-menu-name
opt)>>>>
<\block-if-else|<implied-scm|sty-doc>>
<inline-output|<implied-scm|sty-doc>>.
<|block-if-else>
Paquetage de style non documenté.
</block-if-else>
</explain>
</block-if-else>
</block-for>
</folded>
</block-if>
<\block-if|<implied-scm|(nnull? pars)>>
<\folded|<strong|Paramètres de style>>
<\block-for|<implied-scm|par>|<implied-scm|pars>>
<block-assign|<implied-scm|par-doc>|<\implied-scm>
(tmdoc-search-parameter par)
</implied-scm>>
<\block-if-else|<implied-scm|par-doc>>
<block-output|<implied-scm|par-doc>>
<|block-if-else>
<\explain|<src-var|<output-string|<implied-scm|par>>>>
Un paramètre de type <output-string|<implied-scm|(tree-label-type
(string-\<gtr\>symbol par))>>.
</explain>
</block-if-else>
</block-for>
</folded>
</block-if>
<\block-for|<implied-scm|thm>|<implied-scm|thms>>
<\folded|<strong|Paramètres de style pour le thème
<output-string|<implied-scm|thm>>>>
<\block-for|<implied-scm|par>|<implied-scm|(theme-\<gtr\>members
thm)>>
<block-assign|<implied-scm|par-doc>|<\implied-scm>
(tmdoc-search-parameter par)
</implied-scm>>
<\block-if-else|<implied-scm|par-doc>>
<block-output|<implied-scm|par-doc>>
<|block-if-else>
<\explain|<src-var|<output-string|<implied-scm|par>>>>
Un paramètre de type <output-string|<implied-scm|(tree-label-type
(string-\<gtr\>symbol par))>>.
</explain>
</block-if-else>
</block-for>
</folded>
</block-for>
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-can-move? t)>>
<\unfolded-documentation|Navigation structurée>
Il est parfois utile de traverser rapidement toutes les balises
<markup|<output-string|<implied-scm|tag>>> et ses variantes qui se
trouvent dans un document. Ceci peut se faire efficacement utilisant
des raccourcis claviers, des entrées de menu, ou des icônes sur la
barre de focus :
<\description-long>
<item*|<shortcut|(kbd-select-if-active traverse-first)>,
<menu|Focus|First similar>, <icon|tm_similar_first.xpm>>Aller vers la
première balise similaire à <markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-previous)>,
<menu|Focus|Previous similar>, <icon|tm_similar_previous.xpm>>Aller
vers la balise précédente et similaire à
<markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-next)>,
<menu|Focus|Next similar>, <icon|tm_similar_next.xpm>>Aller vers la
balise suivante et similaire à <markup|<output-string|<implied-scm|tag>>>.
<item*|<shortcut|(kbd-select-if-active traverse-last)>,
<menu|Focus|Last similar>, <icon|tm_similar_last.xpm>>Aller vers la
dernière balise similaire à <markup|<output-string|<implied-scm|tag>>>.
</description-long>
Pour plus de renseignements et d'autres raccourcis clavier utils, nous
vous renvoyons vers la section sur les <help-link|mouvements de curseur
structurés|main/editing/man-structured-move>.
</unfolded-documentation>
</block-if>
<\block-if-else|<implied-scm|(and (defined? 'any-table-tag?)
(any-table-tag? tag))>>
<\unfolded-documentation|Insertions et suppressions structurées>
La balise <markup|<output-string|<implied-scm|tag>>> est un
environnement tabulaire. De nouvelles lignes et colonnes peuvent être
crées de manière suivante :
<\description-long>
<item*|<shortcut|(structured-insert-left)>, <menu|Focus|Insert left>,
<icon|tm_insert_left.xpm>>Insérer une nouvelle colonne à gauche du
curseur.
<item*|<shortcut|(structured-insert-right)>, <menu|Focus|Insert
right>, <icon|tm_insert_right.xpm>>Insérer une nouvelle colonne à
droite du curseur.
<item*|<shortcut|(structured-insert-up)>, <menu|Focus|Insert above>,
<icon|tm_insert_up.xpm>>Insérer une nouvelle ligne au dessus du
curseur.
<item*|<shortcut|(structured-insert-down)>, <menu|Focus|Insert
below>, <icon|tm_insert_down.xpm>>Insérer une nouvelle ligne en
dessous du curseur.
</description-long>
Des lignes et des colonnes existantes peuvent être supprimées comme
suit :
<\description-long>
<item*|<shortcut|(structured-remove-left)>, <menu|Focus|Remove
leftwards>, <icon|tm_delete_left.xpm>>Supprimer la colonne à gauche
du curseur.
<item*|<shortcut|(structured-remove-right)>, <menu|Focus|Remove
rightwards>, <icon|tm_delete_right.xpm>>Supprimer la colonne avec le
curseur et aller vers la colonne d'après.
<item*|<menu|Focus|Remove upwards>, <icon|tm_delete_up.xpm>>Supprimer
la ligne au dessus du curseur.
<item*|<menu|Focus|Remove downwards>,
<icon|tm_delete_down.xpm>>Supprimer la ligne avec le curseur et aller
vers la ligne en dessous.
</description-long>
</unfolded-documentation>
<|block-if-else>
<\block-if-else|<implied-scm|(and (defined? 'field-tags) (tm-in? t
field-tags))>>
<\unfolded-documentation|Insertions et suppressions structurées>
La balise <markup|<output-string|<implied-scm|tag>>> est utilisée à
l'intérieur de sessions interactives. De nouveaux champs d'entrée
peuvent être insérés de manière suivante :
<\description-long>
<item*|<shortcut|(structured-insert-up)>, <menu|Focus|Insert field
above>, <icon|tm_insert_up.xpm>>Insérer un nouveau champ d'entrée
au dessus du curseur.
<item*|<shortcut|(structured-insert-down)>, <menu|Focus|Insert
field below>, <icon|tm_insert_down.xpm>>Insérer un nouveau champ
d'entrée en dessous du curseur.
</description-long>
Des champs d'entrée et de sortie existants peuvent être supprimés
comme suit :
<\description-long>
<item*|<menu|Focus|Remove field above>,
<icon|tm_delete_up.xpm>>Supprimer le champ au dessus du curseur.
<item*|<menu|Focus|Remove field below>,
<icon|tm_delete_down.xpm>>Supprimer le champ courant et aller au
champ suivant.
<item*|<menu|Focus|Remove banner>>Supprimer la bannière de
démarrage de la session.
<item*|<menu|Focus|Remove last field>>Supprimer le dernier champ de
la session.
</description-long>
</unfolded-documentation>
<|block-if-else>
<\block-if|<implied-scm|(or (structured-horizontal? t)
(structured-vertical? t))>>
<\unfolded-documentation|Insertions et suppressions structurées>
La balise <markup|<output-string|<implied-scm|tag>>> admet un
nombre variable d'arguments. De nouveaux arguments peuvent être
insérés de manière suivante :
<\block-texmacs-tag|description-long>
<\block-if|<implied-scm|(structured-horizontal? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-insert-left)>,
<menu|Focus|Insert left>, <icon|tm_insert_left.xpm>>Insérer un
nouvel argument à gauche du curseur.
<inline-texmacs-tag|item*|<shortcut|(structured-insert-right)>,
<menu|Focus|Insert right>, <icon|tm_insert_right.xpm>>Insérer
un nouvel argument à droite du curseur.
</block-if>
<\block-if|<implied-scm|(structured-vertical? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-insert-up)>,
<menu|Focus|Insert above>, <icon|tm_insert_up.xpm>>Insérer un
nouvel argument au dessus du curseur.
<inline-texmacs-tag|item*|<shortcut|(structured-insert-down)>,
<menu|Focus|Insert below>, <icon|tm_insert_down.xpm>>Insérer un
nouvel argument en dessous du curseur.
</block-if>
</block-texmacs-tag>
Des arguments existants peuvent être supprimés comme suit :
<\block-texmacs-tag|description-long>
<\block-if|<implied-scm|(structured-horizontal? t)>>
<inline-texmacs-tag|item*|<shortcut|(structured-remove-left)>,
<menu|Focus|Remove leftwards>,
<icon|tm_delete_left.xpm>>Supprimer l'argument à gauche du
curseur.
<inline-texmacs-tag|item*|<shortcut|(structured-remove-right)>,
<menu|Focus|Remove rightwards>,
<icon|tm_delete_right.xpm>>Supprimer l'argument courant et
aller vers l'argument suivant.
</block-if>
<\block-if|<implied-scm|(structured-vertical? t)>>
<inline-texmacs-tag|item*|<menu|Focus|Remove upwards>,
<icon|tm_delete_up.xpm>>Supprimer l'argument au dessus du
curseur.
<inline-texmacs-tag|item*|<menu|Focus|Remove downwards>,
<icon|tm_delete_down.xpm>>Supprimer l'argument courant et aller
vers la l'argument en dessous.
</block-if>
</block-texmacs-tag>
</unfolded-documentation>
</block-if>
</block-if-else>
</block-if-else>
<\block-if|<implied-scm|(\<less\> (length (tree-accessible-children t))
n)>>
<\unfolded-documentation|Les arguments cachés>
<block-assign|<implied-scm|il>|<implied-scm|(list-filter (.. 0 (length
nl)) (lambda (i) (not (tree-accessible-child? t i))))>>
<block-assign|<implied-scm|sl>|<implied-scm|(map (lambda (i) (list-ref
nl i)) il)>>
Quand la balise <markup|<output-string|<implied-scm|tag>>> est
<help-link|activée|main/text/keyboard/man-dynamic>, les arguments
suivants sont cachés : <inline-intersperse|,
|<inline-for|<implied-scm|x>|<implied-scm|sl>|<src-arg|<output-string|<implied-scm|x>>>>>.
Pour éditer ces arguments, vous pouvez utiliser <menu|Focus|Show
hidden> ou cliquer sur l'icône<nbsp><icon|tm_show_hidden.xpm> de la
barre de focus. Des balises désactivées peuvent être réactivées en
appuyant sur<nbsp><shortcut|(kbd-return)>.
Certains arguments cachés de type chaîne de caractère peuvent aussi
être édités directement via les champs texte sur la barre de focus ;
vous n'avez pas besoin de désactiver la balise dans ce cas.
</unfolded-documentation>
</block-if>
<\block-if|<implied-scm|(focus-has-geometry? t)>>
<\unfolded-documentation|Géométrie structurée>
Non documenté pour l'instant.
</unfolded-documentation>
</block-if>
</body>
<initial|<\collection>
</collection>>

View File

@ -0,0 +1,72 @@
<TeXmacs|1.99.13>
<style|<tuple|tmdoc|automate>>
<\body>
<block-assign|<implied-scm|styles>|<implied-scm|(get-style-list)>>
<block-assign|<implied-scm|style>|<implied-scm|(if (null? styles) "none"
(car styles))>>
<block-assign|<implied-scm|style-doc>|<implied-scm|(tmdoc-search-style
style)>>
<tmdoc-title|Top-level contextual help>
<\unfolded-documentation|Top-level editing>
The <help-link|current focus|main/text/man-structure> is on the entire
document. In this particular situation, the focus toolbar displays some
important information about your document, such as its style
(<tmstyle|<output-string|<implied-scm|style>>>), paper size
(<output-string|<implied-scm|(get-init "page-type")>>) and font size
(<output-string|<implied-scm|(get-init "font-base-size")>>pt). The
toolbar also indicates the current section at the position of your
cursor.
The above properties and the current section can also be changed using
the items on the focus toolbar or in the <menu|Focus> menu. For instance,
by clicking on the current style, paper size or font size, a pulldown
menu will open from which you can modify the current setting. By clicking
on the <icon|tm_add.xpm> icon after the document style, you may select
additional style packages.
Similarly, when clicking on the current section, a pulldown menu with all
sections in the document will open, which allows you to quickly jump to a
particular section. In the case when your cursor is at the start of your
document, and no document title has been entered yet, then
a<nbsp><menu|Title> button will appear for inserting a title. Similarly,
if your cursor is just after the title, then an <menu|Abstract> button
will appear for entering the abstract.
</unfolded-documentation>
<\unfolded-documentation|Current document style>
<\block-if-else|<implied-scm|style-doc>>
<block-output|<implied-scm|style-doc>>
<|block-if-else>
<\explain|<tmstyle|<output-string|<implied-scm|style>>>>
No documentation available.
</explain>
</block-if-else>
</unfolded-documentation>
<\block-if|<implied-scm|(and (nnull? styles) (nnull? (cdr styles)))>>
<\unfolded-documentation|Other active style customizations>
<\block-for|<implied-scm|pack>|<implied-scm|(cdr styles)>>
<block-assign|<implied-scm|pack-doc>|<\implied-scm>
(tmdoc-search-style pack)
</implied-scm>>
<\block-if-else|<implied-scm|pack-doc>>
<block-output|<implied-scm|pack-doc>>
<|block-if-else>
<\explain|<tmpackage|<output-string|<implied-scm|pack>>>>
No documentation available.
</explain>
</block-if-else>
</block-for>
</unfolded-documentation>
</block-if>
</body>
<initial|<\collection>
</collection>>

View File

@ -0,0 +1,73 @@
<TeXmacs|1.99.13>
<style|<tuple|tmdoc|automate|french>>
<\body>
<block-assign|<implied-scm|styles>|<implied-scm|(get-style-list)>>
<block-assign|<implied-scm|style>|<implied-scm|(if (null? styles) "none"
(car styles))>>
<block-assign|<implied-scm|style-doc>|<implied-scm|(tmdoc-search-style
style)>>
<tmdoc-title|Aide contextuelle à la racine>
<\unfolded-documentation|Édition à la racine du document>
Le <help-link|focus actuel|main/text/man-structure> est sur le document
en entier. Dans ce cas précis, la barre de focus (<abbr|c.à.d.> la
troisième barre d'outils) affiche les caractéristiques principales de
votre document, comme son style (<tmstyle|<output-string|<implied-scm|style>>>),
la taille du papier (<output-string|<implied-scm|(get-init
"page-type")>>), et la taille de la police
(<output-string|<implied-scm|(get-init "font-base-size")>>pt). La barre
de focus indique aussi la section dans laquelle se trouve votre curseur.
Les propriétés et la section courante de ci-dessus peuvent également être
modifiées utilisant les icônes et entrées sur la barre de focus, ou
encore depuis le menu <menu|Focus>. Par exemple, en cliquant sur le style
du document, un menu déroulant s'ouvre depuis lequel vous pouvez changer
de style. En cliquant sur l'icône <icon|tm_add.xpm> après le style du
document, vous pouvez également sélectuionner des paquetages de style
supplémentaires.
De même, en cliquant sur la section courante, un menu déroulant s'ouvre
avec toutes les sections du document, ce qui vous permet de rapidement
sauter vers la section de votre choix. Si le curseur se trouve au début
du document et vous ne lui avez pas encore donné de titre, alors un
bouton <menu|Title> à cet effet apparaîtra sur la barre de focus. De
manière similaire, si votre curseur est juste après le titre, un bouton
<menu|Abstract> peut apparaître pour saisir un résumé.
</unfolded-documentation>
<\unfolded-documentation|Style du document>
<\block-if-else|<implied-scm|style-doc>>
<block-output|<implied-scm|style-doc>>
<|block-if-else>
<\explain|<tmstyle|<output-string|<implied-scm|style>>>>
Documentation indisponible.
</explain>
</block-if-else>
</unfolded-documentation>
<\block-if|<implied-scm|(and (nnull? styles) (nnull? (cdr styles)))>>
<\unfolded-documentation|Autres personnalisations de style actives>
<\block-for|<implied-scm|pack>|<implied-scm|(cdr styles)>>
<block-assign|<implied-scm|pack-doc>|<\implied-scm>
(tmdoc-search-style pack)
</implied-scm>>
<\block-if-else|<implied-scm|pack-doc>>
<block-output|<implied-scm|pack-doc>>
<|block-if-else>
<\explain|<tmpackage|<output-string|<implied-scm|pack>>>>
Documentation indisponible.
</explain>
</block-if-else>
</block-for>
</unfolded-documentation>
</block-if>
</body>
<initial|<\collection>
</collection>>