new example file spreadsheet.lyx to show how the spreadsheet support works and to test various spreadsheet formats

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_2_0_X@40121 a592a061-630c-0410-9148-cb99ea01b6c8

development/scons/scons_manifest.py

@@ -2831,6 +2831,7 @@ lib_examples_files = Split('''
     listerrors.lyx
     Literate.lyx
     localization_test.lyx
+    longsheet.gnumeric
     modernCV.lyx
     multicol.lyx
     noweb2lyx.lyx
@@ -2841,8 +2842,12 @@ lib_examples_files = Split('''
     serial_letter1.lyx
     serial_letter2.lyx
     serial_letter3.lyx
+    sheet.gnumeric
+    sheet.ods
+    sheet.xls
     simplecv.lyx
     splash.lyx
+    spreadsheet.lyx
     sweave.lyx
     tufte-book.lyx
     tufte-handout.lyx

lib/Makefile.am

@@ -262,6 +262,7 @@ dist_examples_DATA = \
 	examples/linguistics.lyx \
 	examples/listerrors.lyx \
 	examples/localization_test.lyx \
+	examples/longsheet.gnumeric \
 	examples/modernCV.lyx \
 	examples/multicol.lyx \
 	examples/noweb2lyx.lyx \
@@ -272,8 +273,12 @@ dist_examples_DATA = \
 	examples/serial_letter1.lyx \
 	examples/serial_letter2.lyx \
 	examples/serial_letter3.lyx \
+	examples/sheet.gnumeric \
+	examples/sheet.ods \
+	examples/sheet.xls \
 	examples/simplecv.lyx \
 	examples/splash.lyx \
+	examples/spreadsheet.lyx \
 	examples/sweave.lyx \
 	examples/tufte-book.lyx \
 	examples/tufte-handout.lyx \

lib/examples/spreadsheet.lyx

@@ -0,0 +1,262 @@
+#LyX 2.0 created this file. For more info see http://www.lyx.org/
+\lyxformat 413
+\begin_document
+\begin_header
+\textclass article
+\use_default_options true
+\maintain_unincluded_children false
+\language english
+\language_package default
+\inputencoding auto
+\fontencoding global
+\font_roman default
+\font_sans default
+\font_typewriter default
+\font_default_family default
+\use_non_tex_fonts false
+\font_sc false
+\font_osf false
+\font_sf_scale 100
+\font_tt_scale 100
+
+\graphics default
+\default_output_format default
+\output_sync 0
+\bibtex_command default
+\index_command default
+\paperfontsize default
+\spacing single
+\use_hyperref false
+\papersize a4paper
+\use_geometry false
+\use_amsmath 1
+\use_esint 1
+\use_mhchem 1
+\use_mathdots 1
+\cite_engine basic
+\use_bibtopic false
+\use_indices false
+\paperorientation portrait
+\suppress_date false
+\use_refstyle 1
+\index Index
+\shortcut idx
+\color #008000
+\end_index
+\secnumdepth 3
+\tocdepth 3
+\paragraph_separation skip
+\defskip bigskip
+\quotes_language english
+\papercolumns 1
+\papersides 1
+\paperpagestyle default
+\tracking_changes false
+\output_changes false
+\html_math_output 0
+\html_css_as_file 0
+\html_be_strict false
+\end_header
+
+\begin_body
+
+\begin_layout Title
+Spreadsheets External Inset
+\end_layout
+
+\begin_layout Author
+Helge Hafting
+\end_layout
+
+\begin_layout Standard
+\begin_inset CommandInset toc
+LatexCommand tableofcontents
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Test of spreadsheet external inset in LyX.
+ Spreadsheets (created with Gnumeric, LibreOffice, OpenOffice.org, or Excel)
+ gets converted to .tex with the 
+\family typewriter
+ssconvert
+\family default
+ program that is distributed together with Gnumeric.
+ They are then imported as longtables.
+ As the spreadsheet is 
+\begin_inset Quotes eld
+\end_inset
+
+External material
+\begin_inset Quotes erd
+\end_inset
+
+, any changes to the spreadsheet will be reflected in LyX's output too.
+ Thus, the LyX document is always up to date.
+\end_layout
+
+\begin_layout Section
+How to do it
+\end_layout
+
+\begin_layout Enumerate
+Make a spreadsheet.
+\end_layout
+
+\begin_layout Enumerate
+In LyX use the menu Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+External Material.
+\end_layout
+
+\begin_layout Enumerate
+In the dialog, set template to 
+\family sans
+GnumericSpreadsheet
+\family default
+ and select your spreadsheet file.
+\end_layout
+
+\begin_layout Section
+Simple examples
+\end_layout
+
+\begin_layout Standard
+First, the file 
+\emph on
+sheet.gnumeric, 
+\emph default
+a spreadsheet created with Gnumeric:
+\end_layout
+
+\begin_layout Standard
+\begin_inset External
+	template GnumericSpreadsheet
+	filename sheet.gnumeric
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Then 
+\emph on
+sheet.ods, 
+\emph default
+which was made with OpenOffice.org:
+\end_layout
+
+\begin_layout Standard
+\begin_inset External
+	template GnumericSpreadsheet
+	filename sheet.ods
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Finally 
+\emph on
+sheet.xls 
+\emph default
+which was created with Excel.
+\end_layout
+
+\begin_layout Standard
+\begin_inset External
+	template GnumericSpreadsheet
+	filename sheet.xls
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Section
+Long spreadsheets
+\end_layout
+
+\begin_layout Standard
+A multi-page spreadsheet called 
+\emph on
+longsheet.gnumeric
+\emph default
+.
+ Notice that page breaking works fine:
+\end_layout
+
+\begin_layout Standard
+\begin_inset External
+	template GnumericSpreadsheet
+	filename longsheet.gnumeric
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Section
+Necessary software
+\end_layout
+
+\begin_layout Standard
+LyX needs the converter program 
+\family typewriter
+ssconvert
+\family default
+ that is distributed with Gnumeric.
+ It is therefore necessary to install Gnumeric, even if other software is
+ used to create and edit the spreadsheets.
+\end_layout
+
+\begin_layout Section
+Limitations
+\end_layout
+
+\begin_layout Standard
+Spreadsheet inclusion have some limitations.
+ I don't know all of them, but have seen problem with this:
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring Wide~spreadsheets
+\noindent
+Wide
+\begin_inset space ~
+\end_inset
+
+spreadsheets Unlike long spreadsheets, a spreadsheet wider than the margins
+ doesn't work well.
+ There is no attempt at breaking up such spreadsheets.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring Wide~spreadsheets
+\noindent
+Some
+\begin_inset space ~
+\end_inset
+
+formatting Some types of formatting doesn't work.
+ The red and green texts in the long spreadsheet are underlined.
+ The underlining doesn't show, but the texts is otherwise printed correctly.
+\end_layout
+
+\begin_layout Standard
+These limitations come from 
+\family typewriter
+ssconvert
+\family default
+.
+ Feature requests for better spreadsheet conversions should therefore go
+ to the Gnumeric developers.
+\end_layout
+
+\end_body
+\end_document