1 <sect1 id="sect-file-formats">
2 <title>File Formats</title>
5 &gnum; supports numerous file formats in addition to its own XML
6 based format. The table below lists the formats currently
7 supported. In the table below, the name of the format is a link
8 which can be used to jump to the section which discusses the
12 <!-- TABLE TABLE TABLE TABLE TABLE TABLE -->
13 <table frame='all'><title>The file formats supported by &gnum;</title>
14 <tgroup cols='7' align='left' colsep='1' rowsep='1'>
19 <entry align="left">Format</entry>
20 <entry align="left">Extension</entry>
21 <entry align="left">Open</entry>
22 <entry align="left">Save</entry>
23 <entry align="left">Import</entry>
24 <entry align="left">Export</entry>
25 <entry align="left">MIME type</entry>
30 <entry><link linkend="file-format-gnumeric">Gnumeric</link></entry>
31 <entry><literal>.gnumeric</literal> / <literal>.gnm</literal> / <literal>.xml</literal></entry>
36 <entry>application/x-gnumeric</entry>
39 <entry><link linkend="file-format-applix">Applix</link></entry>
40 <entry><literal>.as</literal></entry>
45 <entry>application/x-applix-spreadsheet</entry>
48 <entry><link linkend="file-format-csv">Comma/Tab/Semicolon Separated Values</link></entry>
49 <entry><literal>.csv</literal>/<literal>.tsv</literal></entry>
54 <entry>text/plain</entry>
57 <entry><link linkend="file-format-dif">Data Interchange Format</link></entry>
58 <entry><literal>.dif</literal></entry>
66 <entry><link linkend="file-format-oleo">GNU Oleo</link></entry>
67 <entry><literal>.oleo</literal></entry>
72 <entry>application/x-oleo</entry>
75 <entry><link linkend="file-format-html">HTML</link></entry>
76 <entry><literal>.html</literal> / <literal>.htm</literal></entry>
81 <entry>text/html</entry>
84 <entry><link linkend="file-format-latex">LaTeX</link></entry>
85 <entry><literal>.tex</literal></entry>
90 <entry>text/x-tex</entry>
93 <entry><link linkend="file-format-mps">Linear and Integer Program</link></entry>
94 <entry>none / <literal>.mps</literal></entry>
99 <entry>application/x-mps</entry>
102 <entry><link linkend="file-format-lotus">Lotus 1-2-3</link></entry>
103 <entry><literal>.wk1</literal> / <literal>.wks</literal></entry>
108 <entry>application/vnd.lotus-1-2-3, application/x-123</entry>
111 <entry><link linkend="file-format-excel-binary-old">Microsoft Excel Old Binary Format
112 (versions 2 - 5)</link></entry>
113 <entry><literal>.xls</literal> / <literal>.xlt</literal> / <literal>.xlw</literal></entry>
118 <entry>application/vnd.ms-excel</entry>
121 <entry><link linkend="file-format-excel-binary-new">Microsoft Excel Binary Format
122 (Excel 95 - 2003)</link></entry>
123 <entry><literal>.xls</literal> / <literal>.xlt</literal> / <literal>.xlw</literal></entry>
128 <entry>application/vnd.ms-excel</entry>
131 <entry><link linkend="file-format-excel-oldxml">Microsoft Excel 2003 SpreadsheetML</link></entry>
132 <entry><literal>.xlsx</literal></entry>
137 <entry>application/vnd.ms-excel</entry>
140 <entry><link linkend="file-format-excel-moox">Microsoft Office Open SpreadsheetML (MOOX/ECMA376/ISO29500)</link></entry>
141 <entry><literal>.xlsx</literal></entry>
146 <entry>application/vnd.ms-excel</entry>
149 <entry><link linkend="file-format-sxc">OpenOffice.Org / StarOffice
150 Old Format</link></entry>
151 <entry><literal>.sxc</literal> / <literal>.stc</literal></entry>
156 <entry>application/vnd.sun.xml.calc</entry>
159 <entry><link linkend="file-format-odf">OpenDocument Format (OASIS ODF and ISO/IEC 26300:2006)</link></entry>
160 <entry><literal>.ods</literal> / <literal>.odt</literal> / <literal>.sxc</literal> / <literal>.stc</literal></entry>
165 <entry>application/vnd.oasis.opendocument.spreadsheet</entry>
168 <entry><!--<link linkend="file-format-paradox">-->Paradox Database<!--</link>--></entry>
169 <entry><literal>.px</literal> / <literal>.db</literal></entry>
177 <entry><link linkend="file-format-planperfect">Plan Perfect</link></entry>
178 <entry><literal>.pln</literal></entry>
183 <entry>application/x-planperfect</entry>
186 <entry><!--<link linkend="file-format-psiconv">-->Psion 5 Sheet Files<!--</link>--></entry>
187 <entry><literal>.psisheet</literal></entry>
195 <entry><link linkend="file-format-ps">PostScript</link></entry>
196 <entry><literal>.ps</literal> / <literal>.eps</literal></entry>
201 <entry>application/postscript</entry>
204 <entry><link linkend="file-format-pdf">PDF</link></entry>
205 <entry><literal>.pdf</literal></entry>
210 <entry>application/pdf</entry>
213 <entry><link linkend="file-format-qpro">Quattro Pro</link></entry>
214 <entry><literal>.wb1</literal> / <literal>.wb2</literal> / <literal>.wb3</literal></entry>
219 <entry>application/x-quattropro, application/x-quattro-pro</entry>
222 <entry><link linkend="file-format-sc">SC/XSpread</link></entry>
223 <entry>none / .<literal>sc</literal></entry>
228 <entry>application/x-sc</entry>
231 <entry><link linkend="file-format-sylk">Multiplan (SYLK)</link></entry>
232 <entry> <literal>.sylk</literal> / <literal>.slk</literal></entry>
237 <entry>application/x-sylk</entry>
240 <entry><link linkend="file-format-text">Text Formats</link></entry>
241 <entry><literal>.txt</literal> / <literal>.text</literal></entry>
246 <entry>text/plain</entry>
249 <entry><link linkend="file-format-troff">TROFF</link></entry>
250 <entry><literal>.me</literal></entry>
255 <entry>application/x-troff</entry>
258 <entry><link linkend="file-format-xbase">Xbase</link></entry>
259 <entry><literal>.dbf</literal></entry>
264 <entry>application/dbase, application/dbf, application/x-dbase,
265 application/x-dbf, application/x-xbase, zz-application/zz-winassoc-dbf</entry>
268 <entry><link linkend="file-format-xhtml">XHTML</link></entry>
269 <entry><literal>.xhtml</literal> / <literal>.html</literal></entry>
274 <entry>application/xhtml+xml</entry>
279 <!-- TABLE TABLE TABLE TABLE TABLE TABLE -->
283 Files in the file formats marked as Save/Open can be opened or saved
285 <guimenuitem>Open</guimenuitem>, <guimenuitem>Save</guimenuitem>,
286 and <guimenuitem>Save As</guimenuitem> menu items in the
287 <guimenuitem>File</guimenuitem> menu.
288 Files in the file formats marked as Import/Export can be imported or
289 exported with the items on the
290 <guimenuitem>Import Data</guimenuitem> and <guimenuitem>Export Data
291 </guimenuitem> submenus of the
292 <guimenuitem>Data</guimenuitem> menu.
298 <sect2 id="file-format-gnumeric">
299 <title>&gnum; XML File Format</title>
302 The &gnum; file format is based on the eXtensible Markup
303 Language (XML) and is used as the default file format.
308 &gnum; is currently using two different systems to process
313 The newer system is based on the SAX processing method for XML
314 and is substantially faster than the older method. This code
315 is based in a plugin module. The exporter is currently used
316 by default but the importer is still incomplete.
320 The older system is part of the core &gnum; program and is
321 still used to open files in the &gnum; format.
326 <informaltable frame='all'>
327 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
331 <emphasis role="bold">Name:</emphasis>
333 <entry>The Gnumeric file format</entry>
337 <emphasis role="bold">Extensions:</emphasis>
339 <entry><literal>.gnumeric</literal></entry>
343 <emphasis role="bold">Compatible Programs:</emphasis>
345 <entry>&gnum;</entry>
349 <emphasis role="bold">Open / Save:</emphasis>
358 <!-- <title></title> -->
361 <emphasis role="bold">Limitations</emphasis>
365 This is the default file format and therefore has the best
366 support of all the formats available. Every feature that
367 can be created in the spreadsheet should be savable using
375 <emphasis role="bold">Plugin</emphasis>
379 The &gnum; file format is handled using two different code
380 bases. The older version is part of the application
381 itself. The newer version is in a plugin called
382 "EXPERIMENTAL SAX based XML" because the parser is based
384 <!-- TODO: explain SAX differences and advantages. -->
391 <emphasis role="bold">Format Details</emphasis>
395 The &gnum; file format stores the file contents in the
396 eXtensible Markup Language (XML) and compresses the file
397 using the GNU project's <application>gzip</application>
402 The &gnum; file format is designed to be flexible and
403 powerful. The format is easily processed by computers. The
404 format can readily be improved as gnumeric develops
405 without breaking compatibility with older versions. The
406 format is designed to be easily translated into text so
407 that it can be read by humans.
411 &gnum; automatically recognizes the version of the file
412 format of any file saved since this format is contained in
413 the file header. The table below is for information
416 <!-- TABLE TABLE TABLE TABLE TABLE TABLE -->
418 <title>Gnumeric XML format versions</title>
419 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
424 <entry align="center">XML File Format Version</entry>
425 <entry align="center">Gnumeric Version</entry>
439 <entry>Since 0.52</entry>
443 <entry>Since 0.57</entry>
447 <entry>Since 0.58</entry>
451 <entry>Since 0.62</entry>
455 <entry>Since 0.66</entry>
459 <entry>Since 0.71</entry>
463 <entry>Since 0.73</entry>
467 <entry>Since 1.03</entry>
475 An outdated PDF document discussing the &gnum; file format
476 which should provide a useful starting point was developed
477 by the JWorkbook project. The file can be downloaded from
478 <literal><ulink type="http"
479 url="http://www.jfree.org/jworkbook/gnumeric-xml.pdf">
480 http://www.jfree.org/jworkbook/gnumeric-xml.pdf</ulink></literal>.
484 An outdated PDF document discussing the &gnum; file format
485 which should provide a useful starting point was developed
486 by the JWorkbook project. The file can be downloaded from
487 <literal><ulink type="http"
488 url="http://www.jfree.org/jworkbook/download/gnumeric-xml.pdf">
489 http://www.jfree.org/jworkbook/download/gnumeric-xml.pdf</ulink></literal>.
498 <emphasis role="bold">Further Processing</emphasis>
502 Direct manipulation of &gnum; files is possible by
503 transforming the files to text files and then using
504 standard text file tools like document editors. In order
505 to read the contents a &gnum; file must first be
506 decompressed and can then be opened. In GNU systems, the
507 &gnum; default file "Book1.gnumeric" can be uncompressed
510 zcat Book1.gnumeric > Book1.text
512 alternatively, the file can be renamed and then
513 uncompressed with the following pair of commands:
515 cp Book1.gnumeric Book1.text.gz
518 both possibilities yield the file "Book1.text" which is
519 an ASCII text file. This file can be opened in any editor,
520 like <application>Vim</application> or
521 <application>Emacs</application>,
522 or pager, like <application>Less</application>.
526 <!-- TODO Ask Shaun: why is this needed to get a par break? -->
528 <!-- TODO: add uses of XML manipulation of .gnumeric files. -->
530 XML manipulation tools can be used to transform &gnum;
531 files and access the data they contain, since the file
532 format is XML. The file can be validated by an XML Schema
533 Definition (XSD) . These are available via the Internet
534 at <uri>http://git.gnome.org/cgit/gnumeric/plain/gnumeric.xsd</uri>.
538 The Java<trademark/> Language can be used to create,
539 access, or manipulate &gnum; format files using the
540 <application>JWorkbook</application> project library. See
541 the project's <ulink type="http"
542 url="http://http://www.jfree.org/jworkbook/index.html">
543 website</ulink> for details.
547 The C# language, through the
548 <application>mono</application> implementation can also be
549 used to manipulate &gnum; format files.
550 <!-- TODO: get link to C# version of JWorkbook
552 <ulink type="http" linkend="" > website</ulink> for
575 <sect2 id="file-format-applix">
576 <title>Applix File Format</title>
579 The Applix file format is used by the
580 <application>Applixware</application> group of applications which
581 include a spreadsheet component. The
582 <application>Applixware</application> spreadsheet is made by
584 url="http://www.vistasource.com">Vistasource</ulink> and
585 claims to be a 'real-time', event driven software system.
589 &gnum; can read some files produced by the
590 <application>Applixware</application> spreadsheet.
593 <informaltable frame='all'>
594 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
598 <emphasis role="bold">Name:</emphasis>
600 <entry>The Applix File Format</entry>
604 <emphasis role="bold">Extensions:</emphasis>
610 <emphasis role="bold">Compatible Programs:</emphasis>
612 <entry>The <application>Applixware</application> Spreadsheet</entry>
616 <emphasis role="bold">Import / Export:</emphasis>
618 <entry>Import only</entry>
625 <!-- <title></title> -->
628 <emphasis role="bold">Limitations</emphasis>
632 Saving <application>Applixware</application> files has
633 recently been disabled due to lack of developer
634 interest. Instead of directly saving a file in the
635 <application>Applix</application> format, files can be
636 exported to <application>Applixware</application> can
637 be performed using the <link
638 linkend="file-format-excel-binary-new">Excel</link> file format.
645 <emphasis role="bold">Plugin</emphasis>
649 Supported by the Applix plugin.
656 <emphasis role="bold">Format Details</emphasis>
671 <sect2 id="file-format-csv">
672 <title>Comma/Tab/Semicolon Separated Value (CSV/TSV) File Formats</title>
674 <!-- TODO: explain locale prob- CSV file comma vs. decimal separator -->
677 The Comma Separated Value (CSV) and Tab Separated Value (TSV) file
679 structuring strategy for text format files. In these files, each
680 line in the file represents a row of data and, within each line
681 of the file, the different data fields are separated from one
682 another using a separator character, often a comma, semicolon or tab.
683 &gnum; handles CSV and TSV files through the text
684 importer and exporter but these formats are given their own
685 definitions in this document because they are considered very common
690 &gnum; will automatically open CSV and TSV format files separating each
691 row into columns based on the presence of appropriate separator
693 the file. If the automatic import leads to any errors, these can
694 generally be corrected by using the "Text Import (configurable)"
695 file format instead. Selecting that file format will launch the
696 <interface>Text Import</interface> druid which allows the user
697 to import CSV and TSV format files while specifying in greater detail
698 the settings of the import configuration parameters. See the
699 section on <link linkend="sect-file-textImport">importing text
700 files</link> or the section on <link
701 linkend="sect-file-textExport">exporting text files</link> for
702 an explanation of how to open or save CSV and TSV files through the
703 <interface>Text Import</interface> druid.
706 <informaltable frame='all'>
707 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
711 <emphasis role="bold">Name:</emphasis>
713 <entry>Comma/Semicolon/Tab Separated Value, CSV/TSV</entry>
717 <emphasis role="bold">Extensions:</emphasis>
719 <entry>.csv, .tsv, .txt</entry>
723 <emphasis role="bold">Compatible Programs:</emphasis>
729 <emphasis role="bold">Import / Export:</emphasis>
738 <!-- <title></title> -->
741 <emphasis role="bold">Limitations</emphasis>
745 The CSV file format is only useful for the exchange of
746 cell data and cannot be used for sheet objects like
747 graphical plots. This file format cannot save the
748 formatting of cell contents, backgrounds or borders.
755 <emphasis role="bold">Plugin</emphasis>
759 Supported by the core &gnum; program.
766 <emphasis role="bold">Format Details</emphasis>
770 CSV files are simple text files where each row of the text
771 file represents one row in the spreadsheet and where the
772 cells within a row are separated from each other by a
780 <emphasis role="bold">Further Processing</emphasis>
784 CSV files can be processed using any tool which operates
785 on text files. The CSV format is also common as a format
786 which can be opened by applications.
794 <emphasis role="italic">See the section on </emphasis>
795 <link linkend="file-format-text">Text Formats</link>
809 <sect2 id="file-format-dif">
810 <title>Data Interchange Format (DIF) File Format</title>
813 The Data Interchange Format (DIF) file format is a text based
814 format encoded in ASCII with a header, for integrity
815 checking, and a body. The format was originally developed by
816 Software Arts in order to transfer data from
817 <application>VisiCalc</application>, the first spreadsheet.
820 <informaltable frame='all'>
821 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
825 <emphasis role="bold">Name:</emphasis>
827 <entry>Data Interchange Format</entry>
831 <emphasis role="bold">Extensions:</emphasis>
837 <emphasis role="bold">Compatible Programs:</emphasis>
839 <entry>Various</entry>
843 <emphasis role="bold">Import / Export:</emphasis>
852 <!-- <title></title> -->
855 <emphasis role="bold">Limitations</emphasis>
859 Since the DIF format only supports a single worksheet,
860 &gnum; only exports the top worksheet in the view used to
868 <emphasis role="bold">Plugin</emphasis>
872 Supported by the <quote>Data Interchange Format
873 (DIF) module</quote> plug-in.
880 <emphasis role="bold">Format Details</emphasis>
884 The format is a text file, encoded in ASCII, with a header
892 <emphasis role="bold">Further Processing</emphasis>
896 The file can be processed as a text file or imported to
897 any program that recognizes the DIF format.
916 <sect2 id="file-format-oleo">
917 <title>GNU Oleo File Format</title>
920 The GNU Oleo file format is the format used by the GNU Oleo
921 spreadsheet, one of the early free software spreadsheets. The
922 GNU Oleo project has stagnated so this format is only supported
923 to enable the import of old files.
926 <informaltable frame='all'>
927 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
931 <emphasis role="bold">Name:</emphasis>
933 <entry>GNU Oleo</entry>
937 <emphasis role="bold">Extensions:</emphasis>
939 <entry>Unknown</entry>
943 <emphasis role="bold">Compatible Programs:</emphasis>
945 <entry><application>GNU oleo</application></entry>
949 <emphasis role="bold">Import / Export:</emphasis>
951 <entry>Open Only</entry>
958 <!-- <title></title> -->
961 <emphasis role="bold">Limitations</emphasis>
972 <emphasis role="bold">Plugin</emphasis>
976 Supported by the 'GNU Oleo' plugin.
983 <emphasis role="bold">Format Details</emphasis>
1004 <!-- TODO: html format edit limitations, encodings. -->
1005 <!-- TODO: html format edit fragment handling (cut and paste) -->
1007 <sect2 id="file-format-html">
1008 <title>The HTML File Format</title>
1011 The Hypertext Markup Language (HTML) file format is a text file
1012 format with markup in the Hypertext Markup Language. These files
1013 are designed to be viewed in a web browser.
1017 &gnum; can save the cell contents in a worksheet to a text file
1018 which consists either of entire, well formed HTML files of
1019 version 3.2 or 4.0, or of a file fragment which contains only a
1020 <table> structure and must be inserted into an HTML
1021 file. &gnum; can also open files which consist only of simple,
1022 well formed HTML <table> structures.
1025 <informaltable frame='all'>
1026 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1030 <emphasis role="bold">Names:</emphasis>
1032 <entry>Hypertext Markup Language (HTML)</entry>
1036 <emphasis role="bold">Extensions:</emphasis>
1038 <entry>.html, .htm</entry>
1042 <emphasis role="bold">Compatible Programs:</emphasis>
1044 <entry>Any Web Browser, any text editor</entry>
1048 <emphasis role="bold">Import / Export:</emphasis>
1050 <entry>Export only, but also can import HTML <table>
1058 <!-- <title></title> -->
1061 <emphasis role="bold">Limitations</emphasis>
1065 Only the cell contents of a worksheet are saved with sheet
1066 object elements, such as graphical plots, ignored.
1073 <emphasis role="bold">Plugin</emphasis>
1077 Supported by the 'HTML & TeX' plugin.
1082 <!-- TODO remove or improve HTML examples
1085 <emphasis role="bold">Format Details</emphasis>
1089 The following figures illustrate the output of the
1090 different HTML file formats.
1093 <figure id="fig-file-format-html32-ex1">
1094 <title>An HTML 3.2 format file</title>
1098 <imagedata fileref="figures/files-html32-example.png"
1102 <phrase>An image of the rendered output of an HTML 3.2
1103 format file generated by Gnumeric.</phrase>
1109 <figure id="file-format-html40-ex1">
1110 <title>An HTML 4.0 format file</title>
1114 <imagedata fileref="figures/files-html40-example.png"
1118 <phrase>An image of the rendered output of an HTML 4.0
1119 format file generated by Gnumeric.</phrase>
1125 <figure id="fig-file-format-html-fragment">
1126 <title>An HTML fragment</title>
1130 <imagedata fileref="figures/files-html-example.png"
1134 <phrase>An image of the rendered output of an HTML fragment
1135 format file generated by Gnumeric, after the
1136 incorporation of this fragment into a valid
1148 <emphasis role="bold">Further Processing</emphasis>
1152 All these files can be opened by any text editor. The HTML
1153 3.2 and 4.0 format files can be opened by any web browser
1154 such as <application>Mozilla</application>.
1157 Files which are generated as HTML fragments must be placed
1158 into an HTML file with a valid pre-amble and closing
1167 <emphasis role="italic">See Also:</emphasis>
1168 <link linkend="file-format-xhtml">XHTML Format</link>
1183 <sect2 id="file-format-latex">
1184 <title>LaTeX File Format</title>
1187 The LaTeX file format is a text file format with markup in the
1188 LaTeX 2ε derivative of the TeX family of languages.
1192 &gnum; generates LaTeX files to allow the export of tables of
1193 numeric values for use in the LaTeX document processing
1194 system. LaTeX is a derived format of the TeX system. The files
1195 generated by &gnum; are designed to be used by a LaTeX
1196 processor, such as <application>latex</application> or
1197 <application>pdflatex</application>, to generate files in
1198 viewable formats such as Device Independent (DVI), PostScript
1199 (PS) or Portable Document Format (PDF).
1203 The generated files can either be processed directly or can be
1204 included in other LaTeX files.
1207 <informaltable frame='all'>
1208 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1212 <emphasis role="bold">Name:</emphasis>
1214 <entry>LaTeX</entry>
1218 <emphasis role="bold">Extensions:</emphasis>
1224 <emphasis role="bold">Compatible Programs:</emphasis>
1226 <entry><application>latex</application>,
1227 <application>pdflatex</application></entry>
1231 <emphasis role="bold">Import / Export:</emphasis>
1233 <entry>Export only</entry>
1240 <!-- <title></title> -->
1243 <emphasis role="bold">Limitations</emphasis>
1247 &gnum; generates a LaTeX <literal>longtable</literal>
1248 structure which contains only the contents of the cells in
1249 the worksheet displayed in the view at the time the file
1253 Font coloring is supported. Thin cell borders are
1254 translated into single lines and thick cell borders are
1255 translated into double lines. Cell background colors are
1263 <emphasis role="bold">Plugin</emphasis>
1267 Supported by the 'HTML & TeX' plugin.
1274 <emphasis role="bold">Format Details</emphasis>
1279 The generated file includes extensive documentation in TeX
1280 comment fields, to explain how to use and alter the
1281 file. Lines in the file which are comments begin and end
1282 with double percent symbols (%%). Lines which are designed
1283 as user options begin with a single percent symbol (%)
1284 which can be deleted to make the LaTeX command on that
1293 <emphasis role="bold">Further Processing</emphasis>
1298 The LaTeX files generated by &gnum; can either be
1299 processed directly by a LaTeX processor or can be included
1300 as tables in other files. The files can be included by
1301 reference as explained below or can be pasted into other
1302 files at the appropriate location. The file can also be
1303 altered to change certain parameters. These alterations
1304 are explained as comments within the file itself and are
1309 The file created by &gnum; can be run directly through a
1310 LaTeX processor without any modifications. For example, if
1311 the file were saved as <filename>Book1.tex</filename>, the
1316 generates a PDF file named
1317 <filename>Book1.pdf</filename>. The file can be generated
1318 in landscape format and the headers, footers and column
1319 widths of the file can be altered in the manner explained
1324 <!-- TODO Ask Shaun: why is this needed to get a par break? -->
1327 The file can also be included within another LaTeX file to
1328 provide a single table. This requires, first, ensuring
1329 that all the packages which will be needed are included, and
1330 second, defining a LaTeX variable which is used as a dummy
1331 tag to exclude the preamble used to process the file on
1332 its own. The LaTeX file generated by &gnum; requires using
1333 the following lines in the preamble
1336 \usepackage{utf8}{inputenc}
1339 \usepackage{longtable}
1341 \usepackage{multirow}
1345 to include each of these packages. Optionally, to include
1346 the table in landscape mode, the preamble also needs the line
1350 to include the <literal>lscape</literal> package. Second,
1353 \def\inputGnumericTable{}
1355 must be included to make the LaTeX processor ignore the
1356 preamble section of the file generated by &gnum;. The
1357 generated file can be included either by adding, at the
1358 appropriate location in the other file, the line
1360 \input{<replaceable>mygnumericfile.tex</replaceable>}
1362 with the text <literal>mygnumericfile</literal> replaced
1363 with the appropriate file name or by pasting the entire
1364 file generated by &gnum; into the other file.
1368 <!-- TODO Ask Shaun: why is this needed to get a par break? -->
1372 An option is provided in the file allows the table to be
1373 presented in landscape mode which allows wider tables to
1374 be included. For files which are to be processed
1375 independently, the option can be changed in the document
1378 \documentclass[12pt%
1382 by removing the percent symbol (%) in front of
1383 <literal>,landscape</literal>. For files to be included as
1384 tables in other LaTeX files, the preamble must include the
1385 <literal>lscape</literal> package, as was explained above,
1386 and the two commands
1388 \def\gnumericTableEnd{\end{landscape}}
1391 must have the leading percent sign removed.
1395 <!-- TODO Ask Shaun: why is this needed to get a par break? -->
1398 An option is provided to change the widths of the columns
1399 of the file generated by &gnum;. By default, the file
1400 attempts to maintain the proportions between the columns
1401 in the &gnum; worksheet, yet scale the resulting table for
1402 the width of the paper defined in LaTeX. To change the
1403 column widths, look for the section in the
1404 <application>LaTeX</application> file with lines that look
1407 \def\gnumericColA{107pt*\gnumericScale}
1408 \def\gnumericColB{89pt*\gnumericScale}
1409 \def\gnumericColC{98pt*\gnumericScale}
1410 \def\gnumericColD{89pt*\gnumericScale}
1411 \def\gnumericColE{89pt*\gnumericScale}
1413 and that may have as many entries as there were columns in
1414 the worksheet. The TeX 'lengths' defined for each column
1415 can be changed. For example, change the second column
1416 (Column B) to a width of 0.75 inches, we would simply have
1417 to modify this code to:
1419 \def\gnumericColA{107pt*\gnumericScale}
1420 \def\gnumericColB{0.75in}
1421 \def\gnumericColC{98pt*\gnumericScale}
1422 \def\gnumericColD{89pt*\gnumericScale}
1423 \def\gnumericColE{89pt*\gnumericScale}
1425 and the resulting file would have a second column 0.75
1430 <!-- TODO Ask Shaun: why is this needed to get a par break? -->
1433 An option to change the headers and footers of the table
1434 is provided as well. The file itself contains comments on
1435 how to alter these but the choices will require seeing the
1436 documentation of the <literal>longtable</literal> LaTeX
1437 package. See that documentation and the contents of the
1438 file generated by &gnum; for details.
1458 <sect2 id="file-format-mps">
1459 <title>Linear and Integer Program Expression (MPS) File Format</title>
1462 The Linear and Integer Program Expression file format is a text
1463 file format, encoded as ASCII, which uses fixed columns. The
1464 format was developed by International Business Machines
1465 Corporation to express linear and integer programs.
1468 <informaltable frame='all'>
1469 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1473 <emphasis role="bold">Name:</emphasis>
1475 <entry>Linear and Integer Program Expression (MPS)</entry>
1479 <emphasis role="bold">Extensions:</emphasis>
1481 <entry>none / .mps</entry>
1485 <emphasis role="bold">Compatible Programs:</emphasis>
1487 <entry>Various linear programming applications</entry>
1491 <emphasis role="bold">Import / Export:</emphasis>
1493 <entry>Import only</entry>
1500 <!-- <title></title> -->
1503 <emphasis role="bold">Limitations</emphasis>
1514 <emphasis role="bold">Plugin</emphasis>
1518 Supported by the 'Linear and integer expression (MPS)
1519 format module' plug-in.
1526 <emphasis role="bold">Format Details</emphasis>
1530 The Argonne National Laboratory of the United States has a
1531 simple <ulink type="ftp"
1532 url="http://www-unix.mcs.anl.gov/otc/Guide/faq/linear-programming-faq.html#Q5"
1533 >introduction</ulink>
1534 to the MPS format on their web site.
1538 The MIPLIB site has more information including a file
1541 url="ftp://softlib.cs.rice.edu/pub/miplib/mps_format"
1542 >mps_format</ulink> which is a brief introduction to the
1543 format and includes the following section:
1545 The following template is a guide for the use of MPS format:
1547 ---------------------------------------------------------------------
1549 Columns: 2-3 5-12 15-22 25-36 40-47 50-61
1558 column row value row value
1561 rhs row value row value
1564 range row value row value
1568 type bound column value
1571 ---------------------------------------------------------------------
1573 and provides further explanations to the components. The
1574 file also suggests as more complete references:
1576 "Advanced Linear Programming," by Bruce A. Murtagh
1577 "Computer Solutions of Linear Programs," by J.L. Nazareth
1579 which should provide a better explanation.
1599 <sect2 id="file-format-lotus">
1600 <title>Lotus 1-2-3 File Format</title>
1603 The Lotus 1-2-3 file format is the format used by the Lotus
1604 <application>1-2-3</application> spreadsheet, which is now part of
1605 the office suite called <application>SmartSuite</application>.
1608 <informaltable frame='all'>
1609 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1613 <emphasis role="bold">Name:</emphasis>
1615 <entry>Lotus 1-2-3</entry>
1619 <emphasis role="bold">Extensions:</emphasis>
1621 <entry>.wk1,.wks</entry>
1625 <emphasis role="bold">Compatible Programs:</emphasis>
1627 <entry>Lotus <application>SmartSuite</application></entry>
1631 <emphasis role="bold">Import / Export:</emphasis>
1633 <entry>Import only</entry>
1640 <!-- <title></title> -->
1643 <emphasis role="bold">Limitations</emphasis>
1654 <emphasis role="bold">Plugin</emphasis>
1658 Supported by the 'Lotus 123' plugin.
1665 <emphasis role="bold">Format Details</emphasis>
1676 <emphasis role="bold">Further Processing</emphasis>
1680 Many spreadsheet programs support this format.
1699 <sect2 id="file-format-excel-binary-old">
1700 <title>Microsoft Excel Old Binary File Format</title>
1703 The Microsoft Excel<trademark/> Old Binary file format is a binary file
1704 format used by the <application>Excel</application> program in
1705 the <application>Office</application> suite between versions 2
1706 and 5. The format is a
1707 common format supported to various extents by most spreadsheets
1708 although it is incompletely documented. The &gnum; project has
1709 reversed engineered all of the core features of the format.
1712 <informaltable frame='all'>
1713 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1717 <emphasis role="bold">Name:</emphasis>
1719 <entry>Excel</entry>
1723 <emphasis role="bold">Extensions:</emphasis>
1729 <emphasis role="bold">Compatible Programs:</emphasis>
1731 <entry>Microsoft <application>Excel</application>,
1732 Microsoft <application>Office</application>,
1733 and many other spreadsheets </entry>
1737 <emphasis role="bold">Open / Save:</emphasis>
1747 <emphasis role="bold">Plugin</emphasis>
1751 Supported by the 'MS Excel (tm)' plugin.
1758 <emphasis role="bold">Format Details</emphasis>
1762 These are binary file formats.
1769 <emphasis role="bold">Further Processing</emphasis>
1773 A number of other programs are able to process files in
1774 the Microsoft Excel file format.
1783 <sect2 id="file-format-excel-binary-new">
1784 <title>Microsoft Excel New Binary File Format</title>
1787 The Microsoft Excel<trademark/> New Binary file format is a binary file
1788 format used by the <application>Excel</application> program in
1789 the <application>Office</application> suite between versions 95
1790 and 2003. The format is a
1791 common format supported to various extents by most spreadsheets
1792 although it is incompletely documented. The &gnum; project has
1793 reversed engineered all of the core features of the format.
1796 <informaltable frame='all'>
1797 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1801 <emphasis role="bold">Name:</emphasis>
1803 <entry>Excel</entry>
1807 <emphasis role="bold">Extensions:</emphasis>
1813 <emphasis role="bold">Compatible Programs:</emphasis>
1815 <entry>Microsoft <application>Excel</application>,
1816 Microsoft <application>Office</application>,
1817 and many other spreadsheets </entry>
1821 <emphasis role="bold">Open / Save:</emphasis>
1831 <emphasis role="bold">Plugin</emphasis>
1835 Supported by the 'MS Excel (tm)' plugin.
1842 <emphasis role="bold">Format Details</emphasis>
1846 These are binary file formats.
1853 <emphasis role="bold">Further Processing</emphasis>
1857 A number of other programs are able to process files in
1858 the Microsoft Excel file format.
1867 <sect2 id="file-format-excel-oldxml">
1868 <title>Microsoft Excel 2003 XML File Format</title>
1871 Microsoft Excel<trademark/> 2003 shipped with a file format
1872 called SpreadsheetML. This file is XML. It is not very common,
1873 but its core features are supported.
1876 <informaltable frame='all'>
1877 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1881 <emphasis role="bold">Name:</emphasis>
1883 <entry>Excel</entry>
1887 <emphasis role="bold">Extensions:</emphasis>
1889 <entry>.xlsx</entry>
1893 <emphasis role="bold">Compatible Programs:</emphasis>
1895 <entry>Microsoft <application>Excel</application>,
1896 Microsoft <application>Office</application>,
1897 and many other spreadsheets </entry>
1901 <emphasis role="bold">Open / Save:</emphasis>
1911 <emphasis role="bold">Plugin</emphasis>
1915 Supported by the 'MS Excel (tm)' plugin.
1922 <emphasis role="bold">Format Details</emphasis>
1926 These are zip files containing SpreadsheetML files and
1934 <emphasis role="bold">Further Processing</emphasis>
1938 This file format is not very widespread and therefore
1939 support by 3rd-party applications is limited.
1948 <sect2 id="file-format-excel-moox">
1949 <title>Microsoft Excel Office Open XML SpreadsheetML</title>
1952 Microsoft Office<trademark/> 2007 shipped with a new set of file
1953 formats, namely the Microsoft Office Open XML SpreadsheetML
1954 format. This format is a semi-open standard based around a
1955 zipped XML file. Microsoft Office Open XML SpreadsheetML is
1956 mostly standardized in ECMA 376 and ISO 29500. This
1957 implementation is covered under the Open Specification Promise
1958 and therefore does not infringe upon Microsoft patents.
1961 <informaltable frame='all'>
1962 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
1966 <emphasis role="bold">Name:</emphasis>
1968 <entry>Excel</entry>
1972 <emphasis role="bold">Extensions:</emphasis>
1978 <emphasis role="bold">Compatible Programs:</emphasis>
1980 <entry>Microsoft <application>Excel</application>,
1981 Microsoft <application>Office</application>,
1982 and many other spreadsheets </entry>
1986 <emphasis role="bold">Open / Save:</emphasis>
1995 <!-- <title></title> -->
1998 <emphasis role="bold">Limitations</emphasis>
2002 Most core features of the format are supported.
2010 <emphasis role="bold">Plugin</emphasis>
2014 Supported by the 'MS Excel (tm)' plugin.
2021 <emphasis role="bold">Format Details</emphasis>
2025 These are zip files containing SpreadsheetML files and
2033 <emphasis role="bold">Further Processing</emphasis>
2037 A number of other programs are able to process files in
2038 the Microsoft Excel file format.
2048 <sect2 id="file-format-excel-xml">
2049 <title>Microsoft Excel XML</title>
2052 The Microsoft Excel<trademark/> file format is a binary file
2053 format used by the <application>Excel</application> program in
2054 the <application>Office</application> suite. The format is a
2055 common format supported to various extents by most spreadsheets
2056 although it is incompletely documented. The &gnum; project has
2057 reversed engineered all of the core features of the format.
2060 <informaltable frame='all'>
2061 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2065 <emphasis role="bold">Name:</emphasis>
2067 <entry>Excel</entry>
2071 <emphasis role="bold">Extensions:</emphasis>
2077 <emphasis role="bold">Compatible Programs:</emphasis>
2079 <entry>Microsoft <application>Excel</application>,
2080 Microsoft <application>Office</application>,
2081 and many other spreadsheets </entry>
2085 <emphasis role="bold">Open / Save:</emphasis>
2094 <!-- <title></title> -->
2097 <emphasis role="bold">Limitations</emphasis>
2101 Most core features of the format are supported.
2106 &gnum; does not support the very old file formats used by
2107 Excel<trademark/> versions prior to Excel<trademark/> 2.0.
2112 &gnum; can open files from most of the Microsoft
2113 Excel<trademark/> file formats and all of the recent file
2114 formats. The formats supported are:
2117 <para> MS Excel<trademark/> 5.0/95.
2121 <para> MS Excel<trademark/> 97/2000/XP.
2125 <para> MS Excel<trademark/> 97/2000/XP & 5.0/95.
2135 <emphasis role="bold">Plugin</emphasis>
2139 Supported by the 'MS Excel (tm)' plugin.
2146 <emphasis role="bold">Format Details</emphasis>
2150 These are binary file formats.
2157 <emphasis role="bold">Further Processing</emphasis>
2161 A number of other programs are able to process files in
2162 the Microsoft Excel file format.
2181 <sect2 id="file-format-sylk">
2182 <title>Multiplan SYLK File Format</title>
2185 The Microsoft Multiplan Symbolic Link Interchange (SYLK) file
2186 format is a column based format.
2190 &gnum; can read files in this format.
2193 <informaltable frame='all'>
2194 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2198 <emphasis role="bold">Name:</emphasis>
2200 <entry>Symbolic Link Interchange (SYLK)</entry>
2204 <emphasis role="bold">Extensions:</emphasis>
2206 <entry>none / .slk</entry>
2210 <emphasis role="bold">Compatible Programs:</emphasis>
2212 <entry><application>Multiplan</application></entry>
2216 <emphasis role="bold">Import / Export:</emphasis>
2218 <entry>Import only</entry>
2225 <!-- <title></title> -->
2228 <emphasis role="bold">Limitations</emphasis>
2239 <emphasis role="bold">Plugin</emphasis>
2243 Supported by the 'Multiplan (SYLK)' plugin.
2250 <emphasis role="bold">Format Details</emphasis>
2266 <sect2 id="file-format-odf">
2267 <title>OpenDocument Format (OASIS ODF and ISO/IEC 26300:2006)</title>
2270 The OpenOffice.org XML file format is zip archive including
2271 several components all of which are text files, most of these with
2272 markup in the eXtensible Markup Language (XML).
2275 <para>&gnum; reads version 1.0, 1.1 and 1.2 of ODF spreadsheet files and writes version 1.2 files
2276 with or without foreign elements. Foreign elements are an extension mechanism defined in ODF and
2277 allow features to be saved in ODF files that are not specifically standardized by ODF.
2278 &gnum; plans to continue to support this format in the future.
2281 <informaltable frame='all'>
2282 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2286 <emphasis role="bold">Name:</emphasis>
2288 <entry>Open Document Format, ODF</entry>
2292 <emphasis role="bold">Extensions:</emphasis>
2298 <emphasis role="bold">Compatible Programs:</emphasis>
2300 <entry><application>OpenOffice.org Calc</application>,
2301 <application>LibreOffice Calc</application>,
2302 <application>KSpread</application>,
2303 <application>StarCalc</application></entry>
2307 <emphasis role="bold">Open / Save:</emphasis>
2316 <!-- <title></title> -->
2319 <emphasis role="bold">Limitations</emphasis>
2330 <emphasis role="bold">Plugin</emphasis>
2334 Supported by the 'Open Document Format' plugin.
2341 <emphasis role="bold">Format Details</emphasis>
2346 The file format is a zip archive containing several text
2347 and XML elements: a <filename>mimetype</filename> file
2348 giving the mime type, a <filename>content.xml</filename>
2349 file with the contents of the spreadsheet cells, and
2350 several other files with meta data, style definitions or
2351 information on the settings. The file contents can be
2352 extracted with the <application>unzip</application>
2353 command line program or with any of a number of graphical
2358 The Organization for the Advancement of Structured
2359 Information Standards (OASIS) has accepted this file
2360 format as the standard "OASIS Open Office XML Format".
2361 The published specification for the file format is
2362 available from the <ulink type="http"
2363 url="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office">
2364 OASIS Open Office XML Format Technical Committee</ulink>
2365 web page. Other information is available from the <ulink
2367 url="http://xml.openoffice.org/">OpenOffice.org XML
2368 File Format</ulink> web page, part of the OpenOffice.org
2373 Version 1.0 of ODF was adopted as an international standard by ISO/IEC as
2382 <emphasis role="bold">Further Processing</emphasis>
2386 Files in this format can be imported and modified by many
2387 different programs including the
2388 <application>OpenOffice.org Calc</application> and
2389 <application>LibreOffice Calc</application> spreadsheets
2390 or may be modified through XML processing.
2399 <sect2 id="file-format-sxc">
2400 <title>OpenOffice.org Old File Format</title>
2403 OpenOffice.org originally shipped with a file format that has
2404 served as a basis for the new OASIS-standardized file format.
2405 This file format is deprecated.
2409 &gnum; can both open and save files in this format and plans to
2410 continue to support this format in the future.
2413 <informaltable frame='all'>
2414 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2418 <emphasis role="bold">Name:</emphasis>
2420 <entry>OpenOffice.org/StarOffice file format</entry>
2424 <emphasis role="bold">Extensions:</emphasis>
2430 <emphasis role="bold">Compatible Programs:</emphasis>
2432 <entry><application>OpenOffice.org Calc</application>,
2433 <application>StarCalc</application></entry>
2437 <emphasis role="bold">Import / Export:</emphasis>
2446 <!-- <title></title> -->
2449 <emphasis role="bold">Limitations</emphasis>
2460 <emphasis role="bold">Plugin</emphasis>
2464 Supported by the 'Open Document Format' plugin.
2471 <emphasis role="bold">Further Processing</emphasis>
2475 This file format is deprecated and is not widely used.
2493 <sect2 id="file-format-planperfect">
2494 <title>Plan Perfect File Format</title>
2497 The Plan Perfect file format is a format used by the
2498 <application>PlanPerfect</application> spreadsheet.
2501 <informaltable frame='all'>
2502 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2506 <emphasis role="bold">Name:</emphasis>
2508 <entry>Plan Perfect</entry>
2512 <emphasis role="bold">Extensions:</emphasis>
2514 <entry>Unknown</entry>
2518 <emphasis role="bold">Compatible Programs:</emphasis>
2520 <entry><application>PlanPerfect</application>.</entry>
2524 <emphasis role="bold">Import / Export:</emphasis>
2526 <entry>Import only</entry>
2533 <!-- <title></title> -->
2536 <emphasis role="bold">Limitations</emphasis>
2547 <emphasis role="bold">Plugin</emphasis>
2551 Supported by the 'Plan Perfect' plug-in.
2558 <emphasis role="bold">Format Details</emphasis>
2569 <emphasis role="bold">Further Processing</emphasis>
2592 <sect2 id="file-format-ps">
2593 <title>PostScript File Format</title>
2596 The PostScript file format is a text format which contains the
2597 program code for a postScript interpreter. PostScript is a page
2598 description language designed to enable the creation and
2599 transfer of printer-ready output.
2604 &gnum; supports the creation of PostScript files through the
2605 printing interface, not through the file save mechanism. See
2606 <xref linkend="chapter-printing" />, for details on how to
2607 generate a PostScript file.
2612 <informaltable frame='all'>
2613 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2617 <emphasis role="bold">Name:</emphasis>
2619 <entry>PostScript</entry>
2623 <emphasis role="bold">Extensions:</emphasis>
2629 <emphasis role="bold">Compatible Programs:</emphasis>
2631 <entry>Many programs can interpret and display PostScript
2632 files including: <application>GGV</application>,
2633 <application>ghostview</application>
2634 (<application>gv</application>), and
2635 <application>ghostscript</application>. </entry>
2639 <emphasis role="bold">Import / Export:</emphasis>
2641 <entry>Export only</entry>
2648 <!-- <title></title> -->
2651 <emphasis role="bold">Limitations</emphasis>
2662 <emphasis role="bold">Plugin</emphasis>
2666 The creation of PostScript files is supported internally
2667 by the printing sub-system.
2674 <emphasis role="bold">Format Details</emphasis>
2678 The PostScript language was created by Adobe, Inc. The
2679 Adobe web site has a non-technical <ulink type="http"
2680 url="http://www.adobe.com/products/postscript/main.html">introduction</ulink>,
2681 as well as a technical <ulink type="http"
2682 url="http://www.adobe.com/products/postscript/overview.html">overview</ulink>
2683 and the actual <ulink type="http"
2684 url="http://partners.adobe.com/asn/tech/ps/specifications.jsp">specifications</ulink>.
2691 <emphasis role="bold">Further Processing</emphasis>
2695 PostScript files can imported into other documents by
2696 several programs. For the very advanced, PostScript files
2697 can be reprogrammed using a text editor.
2716 <sect2 id="file-format-pdf">
2717 <title>Portable Document Format (PDF) File Format</title>
2720 The Portable Document Format (PDF) file format is a binary
2721 format which contains page description primitives and combines a
2722 subset of the Postscript language with some more recent
2723 features. The Portable Document Format is a page description
2724 language designed to enable the creation and transfer of
2725 printer-ready output.
2730 &gnum; supports the creation of PDF files through the
2731 printing interface, not through the file save mechanism. See
2732 <xref linkend="chapter-printing" />, for details on how to
2733 generate a PDF file.
2738 <informaltable frame='all'>
2739 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2743 <emphasis role="bold">Name:</emphasis>
2745 <entry>Portable Document Format (PDF)</entry>
2749 <emphasis role="bold">Extensions:</emphasis>
2755 <emphasis role="bold">Compatible Programs:</emphasis>
2758 PDF is supported by a wide variety of programs including
2759 <application>gPDF</application>,
2760 <application>Xpdf</application>,
2761 <application>GGV</application>,
2762 <application>ghostview</application>
2763 (<application>gv</application>), and
2764 <application>ghostscript</application>, </entry>
2768 <emphasis role="bold">Import / Export:</emphasis>
2770 <entry>Export only</entry>
2777 <!-- <title></title> -->
2780 <emphasis role="bold">Limitations</emphasis>
2791 <emphasis role="bold">Plugin</emphasis>
2795 The creation of PDF files is supported internally
2796 by the printing sub-system.
2803 <emphasis role="bold">Format Details</emphasis>
2807 The Postscript language was created by Adobe, Inc. The
2808 Adobe web site has a non-technical <ulink type="http"
2809 url="http://www.adobe.com/products/postscript/main.html">introduction</ulink>,
2810 as well as a technical <ulink type="http"
2811 url="http://www.adobe.com/products/postscript/overview.html">overview</ulink>
2812 and the actual <ulink type="http"
2813 url="http://partners.adobe.com/asn/tech/ps/specifications.jsp">specifications</ulink>.
2820 <emphasis role="bold">Further Processing</emphasis>
2824 PDF files can imported into other documents by
2844 <sect2 id="file-format-qpro">
2845 <title>Quattro Pro File Format</title>
2848 The Quattro Pro file format is the format used by Corel's
2849 <application>QuattroPro</application> spreadsheet.
2853 &gnum; supports opening these files to import their data.
2856 <informaltable frame='all'>
2857 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2861 <emphasis role="bold">Name:</emphasis>
2863 <entry>Quattro Pro</entry>
2867 <emphasis role="bold">Extensions:</emphasis>
2869 <entry>.wb1 / .wb2 / .wb3</entry>
2873 <emphasis role="bold">Compatible Programs:</emphasis>
2875 <entry><application>Quattro Pro</application></entry>
2879 <emphasis role="bold">Import / Export:</emphasis>
2881 <entry>Import only</entry>
2888 <!-- <title></title> -->
2891 <emphasis role="bold">Limitations</emphasis>
2902 <emphasis role="bold">Plugin</emphasis>
2906 Supported by the Quattro<trademark/> Pro plugin.
2913 <emphasis role="bold">Format Details</emphasis>
2936 <sect2 id="file-format-sc">
2937 <title>SC/Xspread File Format</title>
2940 The SC/Xspread file format is the file format used by the old sc and
2941 Xspread spreadsheets.
2944 <informaltable frame='all'>
2945 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
2949 <emphasis role="bold">Name:</emphasis>
2951 <entry>SC file format</entry>
2955 <emphasis role="bold">Extensions:</emphasis>
2961 <emphasis role="bold">Compatible Programs:</emphasis>
2963 <entry><application>SC</application>,
2964 <application>Xspread</application>,
2965 <application>S</application> spreadsheets.
2970 <emphasis role="bold">Import / Export:</emphasis>
2972 <entry>Import only</entry>
2979 <!-- <title></title> -->
2982 <emphasis role="bold">Limitations</emphasis>
2993 <emphasis role="bold">Plugin</emphasis>
2997 Supported by the 'SC/XSpread' plug-in.
3004 <emphasis role="bold">Format Details</emphasis>
3018 <sect2 id="file-format-text">
3019 <title>Text File Formats</title>
3022 Files in the text file format are files in which the bytes
3023 represent the text characters of a particular character set
3024 using a specific system to relate the binary numbers in the file
3025 to the text characters of the set. Such systems are called
3026 'encodings' and become an issue when the file includes
3027 characters that are not in the standard ASCII set, such as
3028 characters in languages other than English. Character encodings
3029 are explained in greater detail in <xref
3030 linkend="sect-file-textImport-complex-encoding"/>.
3034 Choosing <guimenuitem>Import Text File...</guimenuitem> menu
3036 <guimenuitem>Import Data</guimenuitem> submenu of the
3037 <guimenuitem>Data</guimenuitem> menu or the <guimenuitem>Import
3038 Other File...</guimenuitem> menu item in the
3039 <guimenuitem>Import Data</guimenuitem> submenu of the
3040 <guimenuitem>Data</guimenuitem> menu and specifying the
3041 "Text import (configurable)" or "Text export
3042 (configurable)" file formats to open or save files will cause
3043 &gnum; to start the <interface>Text Import</interface> or
3044 <interface>Text Export</interface> druids. These allow the users
3045 to configure in detail the parameters with which existing files
3046 will be read into a workbook or existing workbooks will be
3051 The Text file format includes a number of different formatting
3052 strategies for text files in which data fields are structured in
3053 a regular pattern. Most of these formats represent rows of data
3054 on different lines of the file using different strategies to
3055 separated data values within each row. 'Fixed-width' formats
3056 place each data entry in a separate column and therefore limit
3057 the size of the data entries. 'Separated' formats use a special
3058 character or character sequence to separate entries. For
3059 instance, the comma separated value, the tab separated value
3060 formats and the space separated value formats use commas, tabs,
3061 and spaces respectively to separate the data fields.
3065 &gnum; can import and export files from and to a wide variety
3067 formats when the text importer or the text exporter is
3068 configured appropriately. File can be generated with many
3069 different encodings. See the section on <link
3070 linkend="sect-file-textImport">importing text files</link> or
3071 the section on <link linkend="sect-file-textExport">exporting
3072 text files</link> for an explanation of how to import or export
3073 these formatted text files.
3076 <informaltable frame='all'>
3077 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
3081 <emphasis role="bold">Name:</emphasis>
3083 <entry>Text File Format</entry>
3087 <emphasis role="bold">Extensions:</emphasis>
3089 <entry><literal>.text</literal> / <literal>.txt</literal>
3094 <emphasis role="bold">Compatible Programs:</emphasis>
3096 <entry>Many programs can read and create formatted text files</entry>
3100 <emphasis role="bold">Import / Export:</emphasis>
3109 <!-- <title></title> -->
3112 <emphasis role="bold">Limitations</emphasis>
3116 The exporter can only create text files using a separator
3117 character and cannot create fixed-width structured files.
3124 <emphasis role="bold">Plugin</emphasis>
3128 Supported by the core &gnum; program.
3135 <emphasis role="bold">Format Details</emphasis>
3139 Text file format files are simple text files containing
3140 the data for each cell of the worksheet organized in a
3148 <emphasis role="bold">Further Processing</emphasis>
3152 Text format files can be processed using any tool which
3153 operates on text files, and many other applications can
3154 read or generate one or more of these formats.
3173 <sect2 id="file-format-troff">
3174 <title><command>TROFF</command> File Format</title>
3177 The <command>TROFF</command> file format is a text file format
3178 with markup in <literal>TROFF</literal>.
3182 The <command>TROFF</command> system is a documentation
3183 preparation system that can generate many different output files
3184 from an input file with standard markup. &gnum; produces a file
3185 that can be used as input to the <command>TROFF</command> system
3186 or its GNU project replacement, <command>GROFF</command>.
3190 The support for this format is mostly intended to produce simple
3191 tables into a file which can be used in the
3192 <command>TROFF</command> system. Since &gnum; supports full
3193 output to Postscript and PDF file formats, those formats should
3194 be used to generate graphics for plots and drawing elements.
3197 <informaltable frame='all'>
3198 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
3202 <emphasis role="bold">Name:</emphasis>
3204 <entry>TROFF</entry>
3208 <emphasis role="bold">Extensions:</emphasis>
3214 <emphasis role="bold">Compatible Programs:</emphasis>
3216 <entry><application>TROFF</application>,
3217 <application>GROFF</application></entry>
3221 <emphasis role="bold">Import / Export:</emphasis>
3223 <entry>Export only</entry>
3230 <!-- <title></title> -->
3233 <emphasis role="bold">Limitations</emphasis>
3244 <emphasis role="bold">Plugin</emphasis>
3248 Supported by the 'HTML & TeX' plugin.
3255 <emphasis role="bold">Format Details</emphasis>
3266 <emphasis role="bold">Further Processing</emphasis>
3274 Two examples of the <command>TROFF</command> system will
3275 illustrate how to use this file format. Both examples
3276 start with a simple worksheet which consists of a simple
3277 grid of cells with cell contents, which has been used to
3278 create a file called "myfile.me" in the
3279 <command>TROFF</command> file format.
3283 A table in PostScript file format can be created starting
3284 from the file generated by &gnum;. The command
3286 groff -me -t -Tps <replaceable>myfile.me</replaceable><replaceable>myfile.ps</replaceable>
3288 will create a PostScript file of the corresponding
3289 table. Note, however, that &gnum; itself can make a
3290 Postscript file of the table directly through the printing
3295 A table in PostScript file format can be created starting
3296 from the file generated by &gnum;. The command
3298 groff -me -t -Tascii <replaceable>myfile.me</replaceable><replaceable>myfile.ascii</replaceable>
3300 creates an <keycap>ascii</keycap> (straight text)
3301 file. This file will look like:
3311 +----------+------------------+-------------+------------+---+
3312 | | Operating System | | | |
3313 +----------+------------------+-------------+------------+---+
3314 | | DOS | Linux | SCO | |
3315 +----------+------------------+-------------+------------+---+
3316 | January | $1000.00 | $900.00 | $500.00 | |
3317 +----------+------------------+-------------+------------+---+
3318 | February | $900.00 | $2500.00 | $300.00 | |
3319 +----------+------------------+-------------+------------+---+
3320 | March | $800.00 | $4100.00 | $100.00 | |
3321 +----------+------------------+-------------+------------+---+
3322 | April | $700.00 | $5700.00 | ($100.00) | |
3323 +----------+------------------+-------------+------------+---+
3324 | May | $600.00 | $7300.00 | ($300.00) | |
3325 +----------+------------------+-------------+------------+---+
3326 | June | $500.00 | $8900.00 | ($500.00) | |
3327 +----------+------------------+-------------+------------+---+
3328 | July | $400.00 | $10500.00 | ($700.00) | |
3329 +----------+------------------+-------------+------------+---+
3330 | August | $300.00 | $12100.00 | ($900.00) | |
3331 +----------+------------------+-------------+------------+---+
3332 |September | $200.00 | $13700.00 | ($1100.00) | |
3333 +----------+------------------+-------------+------------+---+
3334 | October | $100.00 | $15300.00 | ($1300.00) | |
3335 +----------+------------------+-------------+------------+---+
3336 | November | $0.00 | $16900.00 | ($1500.00) | |
3337 +----------+------------------+-------------+------------+---+
3338 | December | ($100.00) | $18500.00 | ($1700.00) | |
3339 +----------+------------------+-------------+------------+---+
3341 +----------+------------------+-------------+------------+---+
3342 | Totals: | $5400.00 | $116400.00 | ($7200.00) | |
3343 +----------+------------------+-------------+------------+---+
3345 +----------+------------------+-------------+------------+---+
3388 <sect2 id="file-format-xbase">
3389 <title>Xbase File Format</title>
3392 The Xbase file format is a file format that includes a series of
3393 files of which one is a text file containing the data and the
3394 rest are index or other files. The data file consists of a
3395 header and then the records themselves.
3399 &gnum; only opens the data file.
3402 <informaltable frame='all'>
3403 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
3407 <emphasis role="bold">Name:</emphasis>
3409 <entry>XBase data file format</entry>
3413 <emphasis role="bold">Extensions:</emphasis>
3419 <emphasis role="bold">Compatible Programs:</emphasis>
3422 <application>dBase</application>,
3423 <application>Clipper</application>,
3424 <application>FoxPro</application>,
3425 <application>Visual dBase</application>,
3426 <application>Visual FoxPro</application>,
3427 and numerous other database applications.
3432 <emphasis role="bold">Import / Export:</emphasis>
3434 <entry>Import only</entry>
3441 <!-- <title></title> -->
3444 <emphasis role="bold">Limitations</emphasis>
3455 <emphasis role="bold">Plugin</emphasis>
3459 Supported by the 'XBase' plugin.
3466 <emphasis role="bold">Format Details</emphasis>
3470 The xBase file format is a generic name for database files
3471 saved in the format used by Aston-Tate's (then Borland's)
3472 <application>dBase</application> database system. The
3473 system became widely popular and has been used extensively
3478 See the <ulink type ="http"
3479 url="http://www.clicketyclick.dk/databases/xbase/format">
3480 Xbase File Format Description</ulink> by Erik Bachmann for
3481 more details on the xBase format.
3498 <!-- TODO: xhtml format edit fragment handling (cut and paste) -->
3501 <sect2 id="file-format-xhtml">
3502 <title>XHTML File Format</title>
3505 The XHTML file format is a text file format with markup in the
3506 eXtensible Markup Language (XML) using a definition which mimics
3507 the Hypertext Markup Language (HTML). These files are designed
3508 to be viewed in a web browser.
3512 <!-- TODO: Explain import of XHTML tables
3513 &gnum; can open well formed xhtml tables placing the data contents of
3514 each entry into a cell of a worksheet.
3516 &gnum; can save the cell contents from a worksheet to a text
3517 file which consists of an XHTML file fragment containing only a
3518 <table> structure, designed to be inserted into another
3522 <informaltable frame='all'>
3523 <tgroup cols='2' align='left' colsep='1' rowsep='1'>
3527 <emphasis role="bold">Name:</emphasis>
3529 <entry>XHTML</entry>
3533 <emphasis role="bold">Extensions:</emphasis>
3535 <entry><literal>.xhtml</literal> / <literal>.html</literal></entry>
3539 <emphasis role="bold">Compatible Programs:</emphasis>
3541 <entry>Most modern web browsers such as
3542 <application>Mozilla</application> and
3543 <application>Mozilla-Firefox</application ></entry>
3547 <emphasis role="bold">Import / Export:</emphasis>
3556 <!-- <title></title> -->
3559 <emphasis role="bold">Limitations</emphasis>
3570 <emphasis role="bold">Plugin</emphasis>
3574 Supported by the 'HTML & TeX' plugin.
3581 <emphasis role="bold">Format Details</emphasis>
3585 The file is generated, encoded in UTF-8, in the World Wide
3586 Web consortium (W3C) XHTML 1.0 Transitional file format.
3593 <emphasis role="bold">Further Processing</emphasis>
3597 These XHTML files can be opened by any text editor and can
3598 be viewed using any web browser such as
3599 <application>Mozilla</application>.
3607 <emphasis role="italic">See Also:</emphasis>
3608 <link linkend="file-format-html">HTML Format</link>