]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/EmbeddedObjects.lyx
Win installer: prepare for next release
[lyx.git] / lib / doc / EmbeddedObjects.lyx
index 71d1e460ea57327d8249e9a814bb85f043154343..dec3ba374ed30730fc8a609e42a35a4f03d825e2 100644 (file)
@@ -1,5 +1,5 @@
-#LyX 2.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 508
+#LyX 2.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 515
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -171,6 +171,7 @@ graphicboxes
 \font_osf false
 \font_sf_scale 100 100
 \font_tt_scale 100 100
+\use_microtype false
 \graphics default
 \default_output_format pdf2
 \output_sync 0
@@ -227,11 +228,13 @@ graphicboxes
 \papercolumns 1
 \papersides 2
 \paperpagestyle default
-\tracking_changes false
+\tracking_changes true
 \output_changes false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict false
+\author 227574939 "Kyttj"
+\author 2047637253 "Guillaume Munch"
 \end_header
 
 \begin_body
@@ -331,7 +334,7 @@ The latest PDF-version of this document can be found here:
 
 
 \series bold
-http://wiki.lyx.org/LyX/DocumentationDevelopment#EmbeddedObjects
+http://wiki.lyx.org/LyX/Manuals#EmbeddedObjects
 \end_layout
 
 \end_inset
@@ -646,10 +649,6 @@ reference "sec:Image-Formats"
 \end_inset
 
  within a separate, horizontally centered paragraph:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -667,10 +666,6 @@ reference "sec:Image-Formats"
 
 \begin_layout Standard
 This is the same image like the one above but in draft mode:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -1705,10 +1700,6 @@ The default table has lines around any cell and the first row appears separated
  have a line below them and the cells of the second row have a line above
  them.
  Here is an example table:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -3315,10 +3306,6 @@ reference "subsec:Multi-page-Table-Captions"
 \begin_layout Standard
 You can also specify a row where the table is split.
  See the following multi-page table to see how it works:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -7705,10 +7692,6 @@ reference "tab:DiffCaptions"
 
  is an example of a multi-page table with different heading where the second
  caption does not include the table number.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -9880,10 +9863,6 @@ must be inserted as \SpecialChar TeX
  Code at the beginning of the cell.
  This ensures that the part of the cell that will be displayed on the new
  page appears with the full width.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -11683,15 +11662,11 @@ Multicolumn
 \end_layout
 
 \begin_layout Standard
-Multicolumns have there own cell settings.
+Multicolumns have their own cell settings.
  That means changing cell borders, cell alignment, and the width only affects
  the multicolumn.
  Here is an example table with a multicolumn cell in the first row and one
  in the last row without the upper border:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -12465,10 +12440,6 @@ Multirow
 
 \begin_layout Standard
 Here is an example table with a multirow in the first column:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -12647,10 +12618,6 @@ mm and is in a 3
 \end_inset
 
 cm wide column:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -12828,10 +12795,6 @@ arg   "newline-insert newline"
 \end_inset
 
 ) but this will not respect the cell lines as demonstrated in this table:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -13240,10 +13203,6 @@ Crystal Clear Pro
 \begin_layout Standard
 The 3-argument scheme is for example useful for cross-tables of sports leagues
  or distances:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -13463,10 +13422,6 @@ Falcons
 \begin_layout Standard
 For larger cross-tables one might use split cells in 2 or every corner of
  the table like in this example:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -13954,10 +13909,6 @@ is used.
 The necessary width of split cells is automatically calculated.
  Thus if you set a fixed column width smaller than the calculated one, the
  cell's content will protrude the cell borders:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -14179,10 +14130,6 @@ diagtest]{A}{B}
 
 \begin_layout Standard
 in the first cell:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -14280,10 +14227,6 @@ Perfect Green
 Note that the split cell needs to be the widest one in the column.
  Otherwise the length of the diagonal line cannot be calculated correctly
  like in this table:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -14395,10 +14338,6 @@ tabcolsep because the cell width is now the width of the column.
 \end_inset
 
 cm is used:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -14548,10 +14487,6 @@ Ctrl+Return
 \end_inset
 
 
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -33150,10 +33085,6 @@ Inner
 Box
 \family default
 , you can align the box content horizontally in the box dialog.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -34169,10 +34100,6 @@ Boxes ! Parboxes
 \begin_layout Standard
 Parboxes are very similar to minipages with the difference that they cannot
  have footnotes.
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -36584,10 +36511,6 @@ reference "sec:Wrap-Floats"
 \end_inset
 
  have these positions in the paragraph:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -37709,10 +37632,6 @@ No optional argument, the initial is the letter 'I' in the math font
 \end_inset
 
 :
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
 \begin_layout Enumerate
 Only one line is surrounding the initial, which is formed by two letters
  in standard font and no text is printed in small caps:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
@@ -37919,12 +37834,6 @@ white
 {
 \backslash
 usepackage{color}}{}
-\series default
-
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper
@@ -38219,67 +38128,6 @@ target "http://en.wikipedia.org/wiki/XBoard"
 .
 \end_layout
 
-\begin_layout Description
-Date This inserts the date in the form 
-\emph on
-Day-Month-Year
-\emph default
-.
- This is a date inserted as external material: 
-\begin_inset External
-       template Date
-       filename .
-
-\end_inset
-
-
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset Note Note
-status collapsed
-
-\begin_layout Plain Layout
-Remove the protected space when bug 4398 is fixed!
-\end_layout
-
-\end_inset
-
-
-\begin_inset Newline newline
-\end_inset
-
-The date is not shown within \SpecialChar LyX
-, only in the output.
- There are two other methods of inserting a date: Via menu 
-\family sans
-Insert\SpecialChar menuseparator
-Date
-\family default
- and with the \SpecialChar LaTeX
- command 
-\series bold
-
-\backslash
-today
-\series default
- as \SpecialChar TeX
- Code.
- The different methods are compared in Table
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "tab:Comparison-of-the"
-
-\end_inset
-
-.
-\end_layout
-
 \begin_layout Description
 Dia
 \begin_inset space ~
@@ -38668,8 +38516,230 @@ target "http://en.wikipedia.org/wiki/Xfig"
 
 \series default
 .
+\change_inserted 227574939 1473131626
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 227574939 1473131628
+Inkscape
+\begin_inset space ~
+\end_inset
+
+figure This experimental template supports 
+\change_inserted 2047637253 1475533187
+SVG 
+\change_inserted 227574939 1473131628
+images
+\change_inserted 2047637253 1475533525
+ that contain text written in \SpecialChar LaTeX
+.
+
+\change_inserted 227574939 1473131628
+\change_inserted 2047637253 1475533551
+It relies on the PDF/PS+\SpecialChar LaTeX
+ option of 
+\change_deleted 2047637253 1475533556
+created with 
+\change_inserted 227574939 1473131628
+the program 
+\begin_inset CommandInset href
+LatexCommand href
+name "Inkscape"
+target "https://en.wikipedia.org/wiki/Inkscape"
+
+\end_inset
+
+.
+\change_inserted 2047637253 1475534005
+As described by the CTAN demonstration package 
+\emph on
+svg-inkscape
+\emph default
+,
+\end_layout
+
+\begin_deeper
+\begin_layout Quote
+
+\change_inserted 2047637253 1475534064
+
+\emph on
+using the 
+\begin_inset Quotes eld
+\end_inset
+
+PDF+\SpecialChar LaTeX
+ output
+\begin_inset Quotes erd
+\end_inset
+
+ option of Inkscape, it is possible to include SVG in documents, in which
+ \SpecialChar LaTeX
+ typesets the text.
+ This results in uniform text style throughout the document, including text
+ in images; moreover, \SpecialChar LaTeX
+ commands may be used in the image’s text, providing
+ such things as mathematics and references.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 2047637253 1475534692
+With Inkscape, even the size of the font is taken from the surrounding \SpecialChar LaTeX
+
+ document.
+ Of course, you can always embed \SpecialChar LaTeX
+ modifiers like 
+\family typewriter
+
+\backslash
+Large
+\family default
+, 
+\family typewriter
+
+\backslash
+small
+\family default
+, etc.
+ into your figure text strings.
+ Refer to the 
+\emph on
+svg-inkscape
+\emph default
+ documentation package for more information and examples.
 \end_layout
 
+\begin_layout Standard
+
+\change_inserted 2047637253 1475534902
+It should be noted that while the image takes into account the surrounding
+ font, its preview in \SpecialChar LyX
+ does not.
+ Wrapping the external inset in a preview inset gives better results in
+ this regard.
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted 2047637253 1475534821
+It
+\change_inserted 2047637253 1475534913
+The template
+\change_inserted 227574939 1473131628
+ works very similarly to Xfig support, except that Inkscape is a more modern
+ image editor than Xfig, which uses Scalable Vector Graphics (SVG) as its
+ native format.
+
+\change_unchanged
+\change_inserted 227574939 1473131628
+LyX will process the image file in much the same way as it does an Xfig
+ image, extracting the text into a separate TeX file for the text strings,
+ and a PDF file for the rest.
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 227574939 1473131628
+Warning: Unfortunately the latest version of Inkscape, 0.91, contains a bug:
+ with multi-page PDFs, the TeX file will sometimes reference more pages
+ than the PDF file contains.
+ This is the version that ships with Ubuntu 16.04.
+ Its use with LyX can therefore not be recommended, until the bug is fixed
+\begin_inset Foot
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 227574939 1473131628
+A workaround for those who have already SVG figures in their document is,
+ to manually do the LaTeX+PDF output from Inkscape, edit the 
+\family typewriter
+.pdf_tex
+\family default
+ file to remove the erroneous references, and 
+\family typewriter
+
+\backslash
+input
+\family default
+ it directly into LyX, i.e., not use the external-template mechanism:
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted 227574939 1473131628
+\begin_inset Graphics
+       filename clipart/workaround.png
+       scale 50
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted 227574939 1473131628
+Here, the child document input inset (
+\family sans
+Insert\SpecialChar menuseparator
+File\SpecialChar menuseparator
+Child Document
+\family default
+) was used, which allows you do directly edit the 
+\family typewriter
+.pdf_tex
+\family default
+ file in a text editor.
+ The LaTeX output is based on this edited snippet as re-generation from
+ the SVG file has been commented out.
+\end_layout
+
+\end_inset
+
+.
+\change_deleted 2047637253 1475534230
+
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted 2047637253 1475534225
+The reason why we would use this complicated process at all, like in the
+ case of Xfig, is that it makes the text strings inside the figure of the
+ same font type and attributes as the surrounding text, which looks so much
+ more professional.
+ With Inkscape, even the 
+\emph on
+size
+\emph default
+ of the font is taken from the surrounding LaTeX document – in Xfig, you
+ have to set it by hand to be the same.
+ Of course you can always embed LaTeX modifiers like 
+\family typewriter
+
+\backslash
+Large
+\family default
+, 
+\family typewriter
+
+\backslash
+small
+\family default
+, etc.
+ into your figure text strings.
+\change_inserted 227574939 1473131628
+
+\end_layout
+
+\end_deeper
 \begin_layout Standard
 \begin_inset Float table
 placement !h
@@ -38698,12 +38768,11 @@ Comparison of the date input methods.
 \begin_layout Plain Layout
 \align center
 \begin_inset Tabular
-<lyxtabular version="3" rows="4" columns="4">
+<lyxtabular version="3" rows="4" columns="3">
 <features tabularvalignment="middle">
 <column alignment="center" valignment="top">
 <column alignment="center" valignment="top">
 <column alignment="center" valignment="top">
-<column alignment="center" valignment="top">
 <row>
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 \begin_inset Text
@@ -38719,18 +38788,6 @@ Document format
 
 \begin_layout Plain Layout
 
-\family sans
-External Material\SpecialChar menuseparator
-Date
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-
 \family sans
 Insert\SpecialChar menuseparator
 Date
@@ -38766,15 +38823,6 @@ today
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 \begin_inset Text
 
-\begin_layout Plain Layout
-as inset box
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
 \begin_layout Plain Layout
 as date
 \end_layout
@@ -38810,15 +38858,6 @@ as \SpecialChar TeX
 as date
 \end_layout
 
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-as date
-\end_layout
-
 \end_inset
 </cell>
 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
@@ -38848,15 +38887,6 @@ DVI, PDF, PS
 as date
 \end_layout
 
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-as date
-\end_layout
-
 \end_inset
 </cell>
 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
@@ -39108,10 +39138,6 @@ Note:
 \begin_layout Description
 Input This method is very similar to the Include method.
  The differences are:
-\begin_inset Separator latexpar
-\end_inset
-
-
 \end_layout
 
 \begin_deeper