documentation_emacs/source/misc/nxml-mode.texi.fr.po
2022-03-08 11:11:57 +01:00

1671 lines
63 KiB
Plaintext

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2021-11-07 12:11+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: top
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:4
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:44
#, no-wrap
msgid "nXML Mode"
msgstr ""
#. type: include
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:5
#, no-wrap
msgid "docstyle.texi"
msgstr ""
#. type: copying
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:11
msgid ""
"This manual documents nXML mode, an Emacs major mode for editing XML with "
"RELAX NG support."
msgstr ""
#. type: copying
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:13
msgid "Copyright @copyright{} 2007--2021 Free Software Foundation, Inc."
msgstr ""
#. type: quotation
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:21
msgid ""
"Permission is granted to copy, distribute and/or modify this document under "
"the terms of the GNU Free Documentation License, Version 1.3 or any later "
"version published by the Free Software Foundation; with no Invariant "
"Sections, with the Front-Cover Texts being ``A GNU Manual,'' and with the "
"Back-Cover Texts as in (a) below. A copy of the license is included in the "
"section entitled ``GNU Free Documentation License''."
msgstr ""
#. type: quotation
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:24
msgid ""
"(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify "
"this GNU manual.''"
msgstr ""
#. type: dircategory
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:27
#, no-wrap
msgid "Emacs editing modes"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:30
msgid "nXML Mode: (nxml-mode)"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:30
msgid "XML editing mode with RELAX NG support."
msgstr ""
#. type: title
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:34
#, no-wrap
msgid "nXML mode"
msgstr ""
#. type: node
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:43
#, no-wrap
msgid "Top"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:49
msgid "This manual is not yet complete."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Introduction::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Completion::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Inserting end-tags::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Paragraphs::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Outlining::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Locating a schema::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "DTDs::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "Limitations::"
msgstr ""
#. type: appendix
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:912
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:913
#, no-wrap
msgid "GNU Free Documentation License"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:60
msgid "The license for this documentation."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:62
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:63
#, no-wrap
msgid "Introduction"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:73
msgid ""
"nXML mode is an Emacs major-mode for editing XML documents. It supports "
"editing well-formed XML documents, and provides schema-sensitive editing "
"using RELAX NG Compact Syntax. To get started, visit a file containing an "
"XML document, and, if necessary, use @kbd{M-x nxml-mode} to switch to nXML "
"mode. By default, @code{auto-mode-alist} and @code{magic-fallback-alist} "
"put buffers in nXML mode if they have recognizable XML content or file "
"extensions. You may wish to customize the settings, for example to "
"recognize different file extensions."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:76
msgid ""
"Once in nXML mode, you can type @kbd{C-h m} for basic information on the "
"mode."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:81
msgid ""
"The @file{etc/nxml} directory in the Emacs distribution contains some data "
"files used by nXML mode, and includes two files (@file{test-valid.xml} and "
"@file{test-invalid.xml}) that provide examples of valid and invalid XML "
"documents."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:89
msgid ""
"To get validation and schema-sensitive editing, you need a RELAX NG Compact "
"Syntax (RNC) schema for your document (@pxref{Locating a schema}). The "
"@file{etc/schema} directory includes some schemas for popular document "
"types. See @url{https://relaxng.org/} for more information on RELAX NG@. "
"You can use the @samp{Trang} program from "
"@url{http://www.thaiopensource.com/relaxng/trang.html} to automatically "
"create RNC schemas. This program can:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:93
msgid "infer an RNC schema from an instance document;"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:95
msgid "convert a DTD to an RNC schema;"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:97
msgid "convert a RELAX NG XML syntax schema to an RNC schema."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:102
msgid ""
"one, you can also use the XSLT stylesheet from "
"@url{https://github.com/oleg-pavliv/emacs/tree/master/xsl}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:111
msgid ""
"To convert a W3C XML Schema to an RNC schema, you need first to convert it "
"to RELAX NG XML syntax using the RELAX NG converter tool @code{rngconv} "
"(built on top of MSV). See @url{https://github.com/kohsuke/msv} and "
"@url{https://msv.dev.java.net/}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:116
msgid ""
"For historical discussions only, see the mailing list archives at "
"@url{http://groups.yahoo.com/group/emacs-nxml-mode/}. Please make all new "
"discussions on the @samp{help-gnu-emacs} and @samp{emacs-devel} mailing "
"lists. Report any bugs with @kbd{M-x report-emacs-bug}."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:118
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:119
#, no-wrap
msgid "Completion"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:126
msgid ""
"Apart from real-time validation, the most important feature that nXML mode "
"provides for assisting in document creation is \"completion\". Completion "
"assists the user in inserting characters at point, based on knowledge of the "
"schema and on the contents of the buffer before point."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:135
msgid ""
"nXML mode adapts the standard GNU Emacs command for completion in a buffer: "
"@code{completion-at-point}, which is bound to @kbd{C-M-i} and "
"@kbd{M-@key{TAB}}. Note that many window systems and window managers use "
"@kbd{M-@key{TAB}} themselves (typically for switching between windows) and "
"do not pass it to applications. In that case, you should type @kbd{C-M-i} "
"or @kbd{@key{ESC} @key{TAB}} for completion, or bind "
"@code{completion-at-point} to a key that is convenient for you. In the "
"following, I will assume that you type @kbd{C-M-i}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:144
msgid ""
"nXML mode completion works by examining the symbol preceding point. This is "
"the symbol to be completed. The symbol to be completed may be the "
"empty. Completion considers what symbols starting with the symbol to be "
"completed would be valid replacements for the symbol to be completed, given "
"the schema and the contents of the buffer before point. These symbols are "
"the possible completions. An example may make this clearer. Suppose the "
"buffer looks like this (where @point{} indicates point):"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:148
#, no-wrap
msgid ""
"<html xmlns=\"http://www.w3.org/1999/xhtml\">\n"
"<h@point{}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:154
msgid ""
"and the schema is XHTML@. In this context, the symbol to be completed is "
"@samp{h}. The possible completions consist of just @samp{head}. Another "
"example, is"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:159
#, no-wrap
msgid ""
"<html xmlns=\"http://www.w3.org/1999/xhtml\">\n"
"<head>\n"
"<@point{}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:166
msgid ""
"In this case, the symbol to be completed is empty, and the possible "
"completions are @samp{base}, @samp{isindex}, @samp{link}, @samp{meta}, "
"@samp{script}, @samp{style}, @samp{title}. Another example is:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:169
#, no-wrap
msgid "<html xmlns=\"@point{}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:174
msgid ""
"In this case, the symbol to be completed is empty, and the possible "
"completions are just @samp{http://www.w3.org/1999/xhtml}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:177
msgid ""
"When you type @kbd{C-M-i}, what happens depends on what the set of possible "
"completions are."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:182
msgid "If the set of completions is empty, nothing happens."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:186
msgid ""
"If there is one possible completion, then that completion is inserted, "
"together with any following characters that are required. For example, in "
"this case:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:190
#, no-wrap
msgid ""
"<html xmlns=\"http://www.w3.org/1999/xhtml\">\n"
"<@point{}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:194
msgid "@kbd{C-M-i} will yield"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:198
#, no-wrap
msgid ""
"<html xmlns=\"http://www.w3.org/1999/xhtml\">\n"
"<head@point{}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:203
msgid ""
"If there is more than one possible completion, but all possible completions "
"share a common non-empty prefix, then that prefix is inserted. For example, "
"suppose the buffer is:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:206
#, no-wrap
msgid "<html x@point{}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:212
msgid ""
"The symbol to be completed is @samp{x}. The possible completions are "
"@samp{xmlns} and @samp{xml:lang}. These share a common prefix of "
"@samp{xml}. Thus, @kbd{C-M-i} will yield:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:215
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:232
#, no-wrap
msgid "<html xml@point{}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:220
msgid ""
"Typically, you would do @kbd{C-M-i} again, which would have the result "
"described in the next item."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:229
msgid ""
"If there is more than one possible completion, but the possible completions "
"do not share a non-empty prefix, then Emacs will prompt you to input the "
"symbol in the minibuffer, initializing the minibuffer with the symbol to be "
"completed, and popping up a buffer showing the possible completions. You "
"can now input the symbol to be inserted. The symbol you input will be "
"inserted in the buffer instead of the symbol to be completed. Emacs will "
"then insert any required characters after the symbol. For example, if it "
"contains:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:236
msgid "Emacs will prompt you in the minibuffer with"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:239
#, no-wrap
msgid "Attribute: xml@point{}\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:243
msgid "and the buffer showing possible completions will contain"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:247
#, no-wrap
msgid ""
"Possible completions are:\n"
"xml:lang xmlns\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:251
msgid "If you input @kbd{xmlns}, the result will be:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:254
#, no-wrap
msgid "<html xmlns=\"@point{}\"\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:259
msgid ""
"(If you do @kbd{C-M-i} again, the namespace URI will be inserted. Should "
"that happen automatically?)"
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:261
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:262
#, no-wrap
msgid "Inserting end-tags"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:267
msgid ""
"The main redundancy in XML syntax is end-tags. nXML mode provides several "
"ways to make it easier to enter end-tags. You can use all of these without "
"a schema."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:270
msgid "You can use @kbd{C-M-i} after @samp{</} to complete the rest of the end-tag."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:275
msgid ""
"@kbd{C-c C-f} inserts an end-tag for the element containing point. This "
"command is useful when you want to input the start-tag, then input the "
"content and finally input the end-tag. The @samp{f} is mnemonic for finish."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:284
msgid ""
"If you want to keep tags balanced and input the end-tag at the same time as "
"the start-tag, before inputting the content, then you can use @kbd{C-c "
"C-i}. This inserts a @samp{>}, then inserts the end-tag and leaves point "
"before the end-tag. @kbd{C-c C-b} is similar but more convenient for "
"block-level elements: it puts the start-tag, point and the end-tag on "
"successive lines, appropriately indented. The @samp{i} is mnemonic for "
"inline and the @samp{b} is mnemonic for block."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:288
msgid ""
"Finally, you can customize nXML mode so that @kbd{/} automatically inserts "
"the rest of the end-tag when it occurs after @samp{<}, by doing"
msgstr ""
#. type: display
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:291
#, no-wrap
msgid ""
"@kbd{M-x customize-variable @key{RET} nxml-slash-auto-complete-flag "
"@key{RET}}\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:295
msgid "and then following the instructions in the displayed buffer."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:296
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:297
#, no-wrap
msgid "Paragraphs"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:304
msgid ""
"Emacs has several commands that operate on paragraphs, most notably "
"@kbd{M-q}. nXML mode redefines these to work in a way that is useful for "
"XML@. The exact rules that are used to find the beginning and end of a "
"paragraph are complicated; they are designed mainly to ensure that @kbd{M-q} "
"does the right thing."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:312
msgid ""
"A paragraph consists of one or more complete, consecutive lines. A group of "
"lines is not considered a paragraph unless it contains some non-whitespace "
"characters between tags or inside comments. A blank line separates "
"paragraphs. A single tag on a line by itself also separates paragraphs. "
"More precisely, if one tag together with any leading and trailing whitespace "
"completely occupy one or more lines, then those lines will not be included "
"in any paragraph."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:318
msgid ""
"A start-tag at the beginning of the line (possibly indented) may be treated "
"as starting a paragraph. Similarly, an end-tag at the end of the line may "
"be treated as ending a paragraph. The following rules are used to determine "
"whether such a tag is in fact treated as a paragraph boundary:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:323
msgid ""
"If the schema does not allow text at that point, then it is a paragraph "
"boundary."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:328
msgid ""
"If the end-tag corresponding to the start-tag is not at the end of its line, "
"or the start-tag corresponding to the end-tag is not at the beginning of its "
"line, then it is not a paragraph boundary. For example, in"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:332
#, no-wrap
msgid ""
"<p>This is a paragraph with an\n"
"<emph>emphasized</emph> phrase.\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:338
msgid ""
"the @samp{<emph>} start-tag would not be considered as starting a paragraph, "
"because its corresponding end-tag is not at the end of the line."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:341
msgid ""
"If there is text that is a sibling in element tree, then it is not a "
"paragraph boundary. For example, in"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:345
#, no-wrap
msgid ""
"<p>This is a paragraph with an\n"
"<emph>emphasized phrase that takes one source line</emph>\n"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:352
msgid ""
"the @samp{<emph>} start-tag would not be considered as starting a paragraph, "
"even though its end-tag is at the end of its line, because there the text "
"@samp{This is a paragraph with an} is a sibling of the @samp{emph} element."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:354
msgid "Otherwise, it is a paragraph boundary."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:356
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:357
#, no-wrap
msgid "Outlining"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:367
msgid ""
"nXML mode allows you to display all or part of a buffer as an outline, in a "
"similar way to Emacs's outline mode. An outline in nXML mode is based on "
"recognizing two kinds of element: sections and headings. There is one "
"heading for every section and one section for every heading. A section "
"contains its heading as or within its first child element. A section also "
"contains its subordinate sections (its subsections). The text content of a "
"section consists of anything in a section that is neither a subsection nor a "
"heading."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:374
msgid ""
"Note that this is a different model from that used by XHTML@. nXML mode's "
"outline support will not be useful for XHTML unless you adopt a convention "
"of adding a @code{div} to enclose each section, rather than having sections "
"implicitly delimited by different @code{h@var{n}} elements. This limitation "
"may be removed in a future version."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:381
msgid ""
"The variable @code{nxml-section-element-name-regexp} gives a regexp for the "
"local names (i.e., the part of the name following any prefix) of section "
"elements. The variable @code{nxml-heading-element-name-regexp} gives a "
"regexp for the local names of heading elements. For an element to be "
"recognized as a section"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:386
msgid "its start-tag must occur at the beginning of a line (possibly indented);"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:389
msgid "its local name must match @code{nxml-section-element-name-regexp};"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:394
msgid ""
"either its first child element or a descendant of that first child element "
"must have a local name that matches @code{nxml-heading-element-name-regexp}; "
"the first such element is treated as the section's heading."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:399
msgid "You can customize these variables using @kbd{M-x customize-variable}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:401
msgid "There are three possible outline states for a section:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:407
msgid ""
"normal, showing everything, including its heading, text content and "
"subsections; each subsection is displayed according to the state of that "
"subsection;"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:411
msgid ""
"showing just its heading, with both its text content and its subsections "
"hidden; all subsections are hidden regardless of their state;"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:415
msgid ""
"showing its heading and its subsections, with its text content hidden; each "
"subsection is displayed according to the state of that subsection."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:420
msgid ""
"In the last two states, where the text content is hidden, the heading is "
"displayed specially, in an abbreviated form. An element like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:426
#, no-wrap
msgid ""
"<section>\n"
"<title>Food</title>\n"
"<para>There are many kinds of food.</para>\n"
"</section>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:430
msgid "would be displayed on a single line like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:433
#, no-wrap
msgid "<-section>Food...</>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:438
msgid ""
"If there are hidden subsections, then a @code{+} will be used instead of a "
"@code{-} like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:441
#, no-wrap
msgid "<+section>Food...</>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:446
msgid ""
"If there are non-hidden subsections, then the section will instead be "
"displayed like this:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:452
#, no-wrap
msgid ""
"<-section>Food...\n"
" <-section>Delicious Food...</>\n"
" <-section>Distasteful Food...</>\n"
"</-section>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:460
msgid ""
"The heading is always displayed with an indent that corresponds to its depth "
"in the outline, even it is not actually indented in the buffer. The "
"variable @code{nxml-outline-child-indent} controls how much a subheading is "
"indented with respect to its parent heading when the heading is being "
"displayed specially."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:468
msgid ""
"Commands to change the outline state of sections are bound to key sequences "
"that start with @kbd{C-c C-o} (@kbd{o} is mnemonic for outline). The third "
"and final key has been chosen to be consistent with outline mode. In the "
"following descriptions current section means the section containing point, "
"or, more precisely, the innermost section containing the character "
"immediately following point."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:473
msgid "@kbd{C-c C-o C-a} shows all sections in the buffer normally."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:476
msgid "@kbd{C-c C-o C-t} hides the text content of all sections in the buffer."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:479
msgid "@kbd{C-c C-o C-c} hides the text content of the current section."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:482
msgid "@kbd{C-c C-o C-e} shows the text content of the current section."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:485
msgid ""
"@kbd{C-c C-o C-d} hides the text content and subsections of the current "
"section."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:488
msgid ""
"@kbd{C-c C-o C-s} shows the current section and all its direct and indirect "
"subsections normally."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:491
msgid ""
"@kbd{C-c C-o C-k} shows the headings of the direct and indirect subsections "
"of the current section."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:495
msgid ""
"@kbd{C-c C-o C-l} hides the text content of the current section and of its "
"direct and indirect subsections."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:498
msgid ""
"@kbd{C-c C-o C-i} shows the headings of the direct subsections of the "
"current section."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:503
msgid ""
"@kbd{C-c C-o C-o} hides as much as possible without hiding the current "
"section's text content; the headings of ancestor sections of the current "
"section and their child section sections will not be hidden."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:508
msgid ""
"When a heading is displayed specially, you can use @key{RET} in that heading "
"to show the text content of the section in the same way as @kbd{C-c C-o "
"C-e}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:516
msgid ""
"You can also use the mouse to change the outline state: @kbd{S-mouse-2} "
"hides the text content of a section in the same way as@kbd{C-c C-o C-c}; "
"@kbd{mouse-2} on a specially displayed heading shows the text content of the "
"section in the same way as @kbd{C-c C-o C-e}; @kbd{mouse-1} on a specially "
"displayed start-tag toggles the display of subheadings on and off."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:525
msgid ""
"The outline state for each section is stored with the first character of the "
"section (as a text property). Every command that changes the outline state "
"of any section updates the display of the buffer so that each section is "
"displayed correctly according to its outline state. If the section "
"structure is subsequently changed, then it is possible for the display to no "
"longer correctly reflect the stored outline state. @kbd{C-c C-o C-r} can be "
"used to refresh the display so it is correct again."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:526
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:527
#, no-wrap
msgid "Locating a schema"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:532
msgid ""
"nXML mode has a configurable set of rules to locate a schema for the file "
"being edited. The rules are contained in one or more schema locating files, "
"which are XML documents."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:546
msgid ""
"The variable @samp{rng-schema-locating-files} specifies the list of the "
"file-names of schema locating files that nXML mode should use. The order of "
"the list is significant: when file @var{x} occurs in the list before file "
"@var{y} then rules from file @var{x} have precedence over rules from file "
"@var{y}. A filename specified in @samp{rng-schema-locating-files} may be "
"relative. If so, it will be resolved relative to the document for which a "
"schema is being located. It is not an error if relative file-names in "
"@samp{rng-schema-locating-files} do not exist. You can use @kbd{M-x "
"customize-variable @key{RET} rng-schema-locating-files @key{RET}} to "
"customize the list of schema locating files."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:555
msgid ""
"By default, @samp{rng-schema-locating-files} list has two members: "
"@samp{schemas.xml}, and @samp{@var{dist-dir}/schema/schemas.xml} where "
"@samp{@var{dist-dir}} is the directory containing the nXML distribution. The "
"first member will cause nXML mode to use a file @samp{schemas.xml} in the "
"same directory as the document being edited if such a file exist. The "
"second member contains rules for the schemas that are included with the nXML "
"distribution."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:559
msgid "Commands for locating a schema::"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:559
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:610
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:611
#, no-wrap
msgid "Schema locating files"
msgstr ""
#. type: section
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:561
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:562
#, no-wrap
msgid "Commands for locating a schema"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:566
msgid ""
"The command @kbd{C-c C-s C-w} will tell you what schema is currently being "
"used."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:576
msgid ""
"The rules for locating a schema are applied automatically when you visit a "
"file in nXML mode. However, if you have just created a new file and the "
"schema cannot be inferred from the file-name, then this will not locate the "
"right schema. In this case, you should insert the start-tag of the root "
"element and then use the command @kbd{C-c C-s C-a}, which reapplies the "
"rules based on the current content of the document. It is usually not "
"necessary to insert the complete start-tag; often just @samp{<@var{name}} is "
"enough."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:590
msgid ""
"If you want to use a schema that has not yet been added to the schema "
"locating files, you can use the command @kbd{C-c C-s C-f} to manually select "
"the file containing the schema for the document in current buffer. Emacs "
"will read the file-name of the schema from the minibuffer. After reading the "
"file-name, Emacs will ask whether you wish to add a rule to a schema "
"locating file that persistently associates the document with the selected "
"schema. The rule will be added to the first file in the list specified "
"@samp{rng-schema-locating-files}; it will create the file if necessary, but "
"will not create a directory. If the variable "
"@samp{rng-schema-locating-files} has not been customized, this means that "
"the rule will be added to the file @samp{schemas.xml} in the same directory "
"as the document being edited."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:605
msgid ""
"The command @kbd{C-c C-s C-t} allows you to select a schema by specifying an "
"identifier for the type of the document. The schema locating files "
"determine the available type identifiers and what schema is used for each "
"type identifier. This is useful when it is impossible to infer the right "
"schema from either the file-name or the content of the document, even though "
"the schema is already in the schema locating file. A situation in which "
"this can occur is when there are multiple variants of a schema where all "
"valid documents have the same document element. For example, XHTML has "
"Strict and Transitional variants. In a situation like this, a schema "
"locating file can define a type identifier for each variant. As with "
"@kbd{C-c C-s C-f}, Emacs will ask whether you wish to add a rule to a schema "
"locating file that persistently associates the document with the specified "
"type identifier."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:609
msgid ""
"The command @kbd{C-c C-s C-l} adds a rule to a schema locating file that "
"persistently associates the document with the schema that is currently being "
"used."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:617
msgid ""
"Each schema locating file specifies a list of rules. The rules from each "
"file are appended in order. To locate a schema each rule is applied in turn "
"until a rule matches. The first matching rule is then used to determine the "
"schema."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:622
msgid ""
"Schema locating files are designed to be useful for other applications that "
"need to locate a schema for a document. In fact, there is nothing specific "
"to locating schemas in the design; it could equally well be used for "
"locating a stylesheet."
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:629
msgid "Schema locating file syntax basics::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:629
msgid "Using the document's URI to locate a schema::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:629
msgid "Using the document element to locate a schema::"
msgstr ""
#. type: menuentry
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:629
msgid "Using type identifiers in schema locating files::"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:629
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:819
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:820
#, no-wrap
msgid "Using multiple schema locating files"
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:631
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:632
#, no-wrap
msgid "Schema locating file syntax basics"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:637
msgid ""
"There is a schema for schema locating files in the file @samp{locate.rnc} in "
"the schema directory. Schema locating files must be valid with respect to "
"this schema."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:644
msgid ""
"The document element of a schema locating file must be @samp{locatingRules} "
"and the namespace URI must be "
"@samp{http://thaiopensource.com/ns/locating-rules/1.0}. The children of the "
"document element specify rules. The order of the children is the same as the "
"order of the rules. Here's a complete example of a schema locating file:"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:651
#, no-wrap
msgid ""
"<?xml version=\"1.0\"?>\n"
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <namespace ns=\"http://www.w3.org/1999/xhtml\" uri=\"xhtml.rnc\"/>\n"
" <documentElement localName=\"book\" uri=\"docbook.rnc\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:663
msgid ""
"This says to use the schema @samp{xhtml.rnc} for a document with namespace "
"@samp{http://www.w3.org/1999/xhtml}, and to use the schema "
"@samp{docbook.rnc} for a document whose local name is @samp{book}. If the "
"document element had both a namespace URI of "
"@samp{http://www.w3.org/1999/xhtml} and a local name of @samp{book}, then "
"the matching rule that comes first will be used and so the schema "
"@samp{xhtml.rnc} would be used. There is no precedence between different "
"types of rule; the first matching rule of any type is used."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:671
msgid ""
"As usual with XML-related technologies, resources are identified by URIs. "
"The @samp{uri} attribute identifies the schema by specifying the URI@. The "
"URI may be relative. If so, it is resolved relative to the URI of the "
"schema locating file that contains attribute. This means that if the value "
"of @samp{uri} attribute does not contain a @samp{/}, then it will refer to a "
"filename in the same directory as the schema locating file."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:672
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:673
#, no-wrap
msgid "Using the document's URI to locate a schema"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:679
msgid ""
"A @samp{uri} rule locates a schema based on the URI of the document. The "
"@samp{uri} attribute specifies the URI of the schema. The @samp{resource} "
"attribute can be used to specify the schema for a particular document. For "
"example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:682
#, no-wrap
msgid "<uri resource=\"spec.xml\" uri=\"docbook.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:687
msgid "specifies that the schema for @samp{spec.xml} is @samp{docbook.rnc}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:700
msgid ""
"The @samp{pattern} attribute can be used instead of the @samp{resource} "
"attribute to specify the schema for any document whose URI matches a "
"pattern. The pattern has the same syntax as an absolute or relative URI "
"except that the path component of the URI can use a @samp{*} character to "
"stand for zero or more characters within a path segment (i.e., any character "
"other @samp{/}). Typically, the URI pattern looks like a relative URI, but, "
"whereas a relative URI in the @samp{resource} attribute is resolved into a "
"particular absolute URI using the base URI of the schema locating file, a "
"relative URI pattern matches if it matches some number of complete path "
"segments of the document's URI ending with the last path segment of the "
"document's URI@. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:703
#, no-wrap
msgid "<uri pattern=\"*.xsl\" uri=\"xslt.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:708
msgid ""
"specifies that the schema for documents with a URI whose path ends with "
"@samp{.xsl} is @samp{xslt.rnc}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:721
msgid ""
"A @samp{transformURI} rule locates a schema by transforming the URI of the "
"document. The @samp{fromPattern} attribute specifies a URI pattern with the "
"same meaning as the @samp{pattern} attribute of the @samp{uri} element. The "
"@samp{toPattern} attribute is a URI pattern that is used to generate the URI "
"of the schema. Each @samp{*} in the @samp{toPattern} is replaced by the "
"string that matched the corresponding @samp{*} in the @samp{fromPattern}. "
"The resulting string is appended to the initial part of the document's URI "
"that was not explicitly matched by the @samp{fromPattern}. The rule matches "
"only if the transformed URI identifies an existing resource. For example, "
"the rule"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:724
#, no-wrap
msgid "<transformURI fromPattern=\"*.xml\" toPattern=\"*.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:734
msgid ""
"would transform the URI @samp{file:///home/jjc/docs/spec.xml} into the URI "
"@samp{file:///home/jjc/docs/spec.rnc}. Thus, this rule specifies that to "
"locate a schema for a document @samp{@var{foo}.xml}, Emacs should test "
"whether a file @samp{@var{foo}.rnc} exists in the same directory as "
"@samp{@var{foo}.xml}, and, if so, should use it as the schema."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:735
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:736
#, no-wrap
msgid "Using the document element to locate a schema"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:740
msgid ""
"A @samp{documentElement} rule locates a schema based on the local name and "
"prefix of the document element. For example, a rule"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:743
#, no-wrap
msgid ""
"<documentElement prefix=\"xsl\" localName=\"stylesheet\" "
"uri=\"xslt.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:751
msgid ""
"specifies that when the name of the document element is "
"@samp{xsl:stylesheet}, then @samp{xslt.rnc} should be used as the "
"schema. Either the @samp{prefix} or @samp{localName} attribute may be "
"omitted to allow any prefix or local name."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:754
msgid ""
"A @samp{namespace} rule locates a schema based on the namespace URI of the "
"document element. For example, a rule"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:757
#, no-wrap
msgid "<namespace ns=\"http://www.w3.org/1999/XSL/Transform\" uri=\"xslt.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:763
msgid ""
"specifies that when the namespace URI of the document is "
"@samp{http://www.w3.org/1999/XSL/Transform}, then @samp{xslt.rnc} should be "
"used as the schema."
msgstr ""
#. type: subsection
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:764
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:765
#, no-wrap
msgid "Using type identifiers in schema locating files"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:778
msgid ""
"Type identifiers allow a level of indirection in locating the schema for a "
"document. Instead of associating the document directly with a schema URI, "
"the document is associated with a type identifier, which is in turn "
"associated with a schema URI@. nXML mode does not constrain the format of "
"type identifiers. They can be simply strings without any formal structure "
"or they can be public identifiers or URIs. Note that these type identifiers "
"have nothing to do with the DOCTYPE declaration. When comparing type "
"identifiers, whitespace is normalized in the same way as with the "
"@samp{xsd:token} datatype: leading and trailing whitespace is stripped; "
"other sequences of whitespace are normalized to a single space character."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:784
msgid ""
"Each of the rules described in previous sections that uses a @samp{uri} "
"attribute to specify a schema, can instead use a @samp{typeId} attribute to "
"specify a type identifier. The type identifier can be associated with a URI "
"using a @samp{typeId} element. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:792
#, no-wrap
msgid ""
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <namespace ns=\"http://www.w3.org/1999/xhtml\" typeId=\"XHTML\"/>\n"
" <typeId id=\"XHTML\" typeId=\"XHTML Strict\"/>\n"
" <typeId id=\"XHTML Strict\" uri=\"xhtml-strict.rnc\"/>\n"
" <typeId id=\"XHTML Transitional\" uri=\"xhtml-transitional.rnc\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:801
msgid ""
"declares three type identifiers @samp{XHTML} (representing the default "
"variant of XHTML to be used), @samp{XHTML Strict} and @samp{XHTML "
"Transitional}. Such a schema locating file would use "
"@samp{xhtml-strict.rnc} for a document whose namespace is "
"@samp{http://www.w3.org/1999/xhtml}. But it is considerably more flexible "
"than a schema locating file that simply specified"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:804
#, no-wrap
msgid "<namespace ns=\"http://www.w3.org/1999/xhtml\" uri=\"xhtml-strict.rnc\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:809
msgid ""
"A user can easily use @kbd{C-c C-s C-t} to select between XHTML Strict and "
"XHTML Transitional. Also, a user can easily add a catalog"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:814
#, no-wrap
msgid ""
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <typeId id=\"XHTML\" typeId=\"XHTML Transitional\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:818
msgid "that makes the default variant of XHTML be XHTML Transitional."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:827
msgid ""
"The @samp{include} element includes rules from another schema locating "
"file. The behavior is exactly as if the rules from that file were included "
"in place of the @samp{include} element. Relative URIs are resolved into "
"absolute URIs before the inclusion is performed. For example,"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:830
#, no-wrap
msgid "<include rules=\"../rules.xml\"/>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:834
msgid "includes the rules from @samp{rules.xml}."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:841
msgid ""
"The process of locating a schema takes as input a list of schema locating "
"files. The rules in all these files and in the files they include are "
"resolved into a single list of rules, which are applied strictly in order. "
"Sometimes this order is not what is needed. For example, suppose you have "
"two schema locating files, a private file"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:846
#, no-wrap
msgid ""
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <namespace ns=\"http://www.w3.org/1999/xhtml\" uri=\"xhtml.rnc\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:850
msgid "followed by a public file"
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:856
#, no-wrap
msgid ""
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <transformURI pathSuffix=\".xml\" replacePathSuffix=\".rnc\"/>\n"
" <namespace ns=\"http://www.w3.org/1999/XSL/Transform\" typeId=\"XSLT\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:863
msgid ""
"The effect of these two files is that the XHTML @samp{namespace} rule takes "
"precedence over the @samp{transformURI} rule, which is almost certainly not "
"what is needed. This can be solved by adding an @samp{applyFollowingRules} "
"to the private file."
msgstr ""
#. type: example
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:869
#, no-wrap
msgid ""
"<locatingRules xmlns=\"http://thaiopensource.com/ns/locating-rules/1.0\">\n"
" <applyFollowingRules ruleType=\"transformURI\"/>\n"
" <namespace ns=\"http://www.w3.org/1999/xhtml\" uri=\"xhtml.rnc\"/>\n"
"</locatingRules>\n"
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:871
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:872
#, no-wrap
msgid "DTDs"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:886
msgid ""
"nXML mode is designed to support the creation of standalone XML documents "
"that do not depend on a DTD@. Although it is common practice to insert a "
"DOCTYPE declaration referencing an external DTD, this has undesirable "
"side-effects. It means that the document is no longer self-contained. It "
"also means that different XML parsers may interpret the document in "
"different ways, since the XML Recommendation does not require XML parsers to "
"read the DTD@. With DTDs, it was impractical to get validation without "
"using an external DTD or reference to an parameter entity. With RELAX NG "
"and other schema languages, you can simultaneously get the benefits of "
"validation and standalone XML documents. Therefore, I recommend that you do "
"not reference an external DOCTYPE in your XML documents."
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:896
msgid ""
"One problem is entities for characters. Typically, as well as providing "
"validation, DTDs also provide a set of character entities for documents to "
"use. Schemas cannot provide this functionality, because schema validation "
"happens after XML parsing. The recommended solution is to either use the "
"Unicode characters directly, or, if this is impractical, use character "
"references. nXML mode supports this by providing commands for entering "
"characters and character references using the Unicode names, and can display "
"the glyph corresponding to a character reference."
msgstr ""
#. type: chapter
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:897
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:898
#, no-wrap
msgid "Limitations"
msgstr ""
#. type: Plain text
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:901
msgid "nXML mode has some limitations:"
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:907
msgid ""
"DTD support is limited. Internal parsed general entities declared in the "
"internal subset are supported provided they do not contain elements. Other "
"usage of DTDs is ignored."
msgstr ""
#. type: itemize
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:910
msgid ""
"The restrictions on RELAX NG schemas in section 7 of the RELAX NG "
"specification are not enforced."
msgstr ""
#. type: include
#: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs -
#: Sources/doc/misc/nxml-mode.texi:914
#, no-wrap
msgid "doclicense.texi"
msgstr ""