Dutch doc updates by Niko

[lyx.git] / lib / examples / README.new_examples

diff --git a/lib/examples/README.new_examples b/lib/examples/README.new_examples
index b71897fb6c69fddd4e2af8e397da681e88b2de09..c14db7a79ee190c9d331d9381a8aaba2e862dac4 100644 (file)
--- a/lib/examples/README.new_examples
+++ b/lib/examples/README.new_examples
@@ -7,18 +7,18 @@ examples/[language/]category/[subcategory]
 
 Please use the layout category (with identical spelling to assure translation)
 as category subdirectory (e.g., "Letters"). See \DeclareCategory entry of the
-layout which corresponds to your example. Substitute blanks by '_'.
+layout which corresponds to your example. Note the handling of special characters
+below.
 
 If your example consists of one file only, and if there are no further examples
 relating to your layout yet, use the layout name, as defined in \DeclareLaTeXClass,
-as file name. Substitute blanks by '_' (e.g., My_Layout.lyx). In any case, use
-a verbose, transparent name (do not use insider acronyms as file names).
+as file name. In any case, use a verbose, transparent name (do not use insider acronyms
+as file names). Note the handling of special characters below.
 
 If your example consists of multiple files, use an additional subdirectory.
 Use the layout name, as defined in \DeclareLaTeXClass, as subcategory subfolder
-name. Substitute blanks by '_' (e.g., My_Layout). Give the files verbose,
-transparent names that clarify the function of the respective file in the examples
-bundle. Use '_' instead of blanks.
+name. Give the files verbose, transparent names that clarify the function of the respective
+file in the examples bundle. Note the handling of special characters below.
 
 The optional language subdirectory that immediately follows examples/ uses the
 language code (e.g., 'de' for German). Use this if you provide a translation of
@@ -27,5 +27,30 @@ The language subdirectory expands to the same subfolders than the English versio
 and uses the same [English) filename (e.g., examples/Letters/myletter.lyx > 
 examples/fr/Letters/myletter.lyx).
 
-If you add a new (sub)folder, you must create a new entry in Makefile.am.
+
+NB: SPECIAL CHARACTERS IN FILE AND DIRECTORY NAMES:
+===================================================
+
+The following characters in file and directory names must be substituted, since they break
+LyX building with autotools:
+
+* Blanks by '_' (e.g., My_Layout.lyx)
+* Parentheses by %28 and %29 (e.g., My_Layout_%28v._1%29.lyx)
+* Apersands by %26 (e.g., Journal_of_This_%26_That.lyx)
+
+The substitution characters will be replaced again for LyX for translation and GUI display.
+
+
+THINGS TO CHECK BEFORE COMMITTING:
+==================================
+
+New files must be added to Makefile.am. If you add a new (sub)folder, you must also create a new category
+in Makefile.am (cf. dehandoutexamplesdir and dist_phdthesistemplates_DATA as example).
+
+Please make sure before you commit (in a text editor) that the example that the file has the correct
+\origin specification. It should begin with /systemlyxdir/ and then point towards the subdirectory
+your file is in, e.g.
+\origin /systemlyxdir/templates/es/Presentations/
+This is particularly important if your file includes other files (such as graphics, bibliographies,
+children).