/[public]/psiconv/trunk/README

Diff of /psiconv/trunk/README

Parent Directory | Revision Log | View Patch Patch

Revision 2		Revision 152
…		…
6	they may profit from the data I collected.	6	they may profit from the data I collected.
7		7
8	The package consists of several parts:	8	The package consists of several parts:
9	* Documentation about Psion 5 data formats;	9	* Documentation about Psion 5 data formats;
10	* A library which can be linked against application that have to read	10	* A library which can be linked against application that have to read
11	(and in the future, perhaps write) Psion 5 files;	11	and write Psion 5 files;
12	* An example command-line program which reads Psion files and writes	12	* An example command-line program which reads Psion files and writes
13	more commonly used formats.	13	more commonly used formats.
14		14
15		15
16	DATA FORMATS	16	DATA FORMATS
…		…
18		18
19	As far as I know, and have gathered from the newsgroups, Psion does not want	19	As far as I know, and have gathered from the newsgroups, Psion does not want
20	or is not able to release the data formats of the saved files of their	20	or is not able to release the data formats of the saved files of their
21	internal applications. I am trying to reverse engineer these data formats	21	internal applications. I am trying to reverse engineer these data formats
22	and to document them for general use. At this moment, I understand their	22	and to document them for general use. At this moment, I understand their
23	Word, TextEd, Sketch, MBM and Record files. I want this information to	23	Word, Sheet, TextEd, Sketch, MBM, Clipart and Record files, as well as a
		24	few other less important formats. I want this information to be available
24	be available to everyone, in order to write better file conversion utilities	25	to everyone, in order to write better file conversion utilities for popular
25	for popular (non-)Windows programs.	26	(non-)Windows programs.
26		27
27	All documentation is written in Psion 5 Word. Fortunately, the utilities	28	All documentation is written in Psion 5 Word. Fortunately, the utilities
28	in this package can translate it to HTML and other formats.	29	in this package can translate it to HTML and other formats.
29		30
30	Unlike all other files in this package, the *.psi files in the directory	31	Unlike all other files in this package, the *.psi files in the directory
…		…
38		39
39	THE LIBRARY	40	THE LIBRARY
40	===========	41	===========
41		42
42	libpsiconv is a library of routines that you can link against your own	43	libpsiconv is a library of routines that you can link against your own
43	application. It allows you to read Psion 5 files, and helps you output	44	application. It allows you to read Psion 5 files. Note that it comes
44	more commonly used files. Note that it comes under the GNU General	45	under the GNU General Public License; that means that you can only link
45	Public License; that means that you can only link it to programs which	46	it to programs which are also covered by that license. You can contact
46	are also covered by that license. You can contact me if you need other	47	me if you need other license terms.
47	license terms.
48		48
49	Libpsiconv consists of two parts. The parser reads the Psion file into its	49	The following formats can be read at this moment:
50	internal data structures. The generator reads these data structures and	50	Word Word processor files
51	generates an output file in some other format. Libpsiconv is written to make	51	TextEd OPL editor files
52	it easy to add generators, without having to modify the parser side.	52	Sketch Picture files
53	Actually, it is a lot easier to write a generator than to modify the parser!	53	MBM Alternate picture format; several pictures can be combined in it
		54	ClipArt Internal picture format; several pictures can be combined in it
54		55
55	The parser is quite good at the moment. Page layout codes are not yet	56	The parser is quite good at the moment. Page layout codes are not yet
56	read, but almost everything that is described in the documents in the	57	read, but almost everything that is described in the documents in the
57	format directory is supported by it. Of course, it can also not yet	58	format directory is supported by it; but it can not yet cope with
58	cope with inserted objects (ie. documents in some other format) and	59	inserted objects (ie. documents in some other format).
59	other as of yet undocumented things.
60
61	The current HTML target is not very ideal. HTML is just not made to
62	represent detailed layout considerations: it is a document description
63	language. Still, the output is quite readable already. Of course, headers
64	and footers are not displayed, because there is no notion of pages in
65	HTML. Tabs are also difficult; they are not supported yet. This can be
66	solved using tables, but it is quite hard to do it correctly. Some other
67	things are just approximated too.
68
69	The HTML4 target uses style sheets. You need a not-too-old browser for
70	this to display correctly. Generally, the output of this generator is
71	of higher quality than the normal HTML generator's.
72
73	A plain TEXT target just grabs all text, without any futher conversions.
74
75	I would very much like to add other targets, like (La)TeX, RTF (Rich Text
76	Format) and XML (for AbiWord). If other people want to work on this, please
77	let me know! Of course, you could also write your own conversion applications
78	just using my data format description. Native import/export filters for
79	some word processors would be very welcome!
80		60
81	Documentation is scarce; please examine the source code or the example	61	Documentation is scarce; please examine the source code or the example
82	psiconv program. Some things may also be found in the doc subdirectory.	62	psiconv program. Some things may also be found in the doc subdirectory.
83		63
84		64
…		…
89	more commonly used formats. It is linked against libpsiconv, and can	69	more commonly used formats. It is linked against libpsiconv, and can
90	handle anything that it can.	70	handle anything that it can.
91		71
92	Please enter `psiconv --help' if you want to know about its syntax.	72	Please enter `psiconv --help' if you want to know about its syntax.
93		73
		74	The current HTML3 target is not very ideal. HTML is just not made to
		75	represent detailed layout considerations: it is a document description
		76	language. Still, the output is quite readable already. Of course, headers
		77	and footers are not displayed, because there is no notion of pages in
		78	HTML. Tabs are also difficult; they are not supported yet. This can be
		79	solved using tables, but it is quite hard to do it correctly. Some other
		80	things are just approximated too.
		81
		82	The HTML4 target uses style sheets. You need a not-too-old browser for
		83	this to display correctly. Generally, the output of this generator is
		84	of higher quality than the normal HTML generator's.
		85
		86	A plain TEXT target just grabs all text, without any futher conversions.
		87
		88	The RTF target is not finished yet; in fact, it is no usable at all
		89	right now.
		90
		91	All ImageMagick graphic output formats are supported; depending on how
		92	you compiled ImageMagick, this is betwee 20 and 50 different formats.
		93	Your favorite one should be somewhere in there...
		94
		95	I would very much like to add other targets, like (La)TeX, RTF (Rich Text
		96	Format) and XML (for AbiWord). If other people want to work on this, please
		97	let me know! Of course, you could also write your own conversion applications
		98	just using my data format description. Native import/export filters for
		99	some word processors would be very welcome!
		100
94	Psiconv is licensed under the GPL. Please read the included file COPYING	101	Psiconv is licensed under the GPL. Please read the included file COPYING
95	for exact licensing information. Please contact me if you need some other	102	for exact licensing information. Please contact me if you need some other
96	licensing terms.	103	licensing terms.
97		104
98		105
…		…
100	============================	107	============================
101		108
102	Starting with version 0.2, psiconv should keep all namespaces unpoluted.	109	Starting with version 0.2, psiconv should keep all namespaces unpoluted.
103	Starting with version 0.4, the conversion routines are linked into a	110	Starting with version 0.4, the conversion routines are linked into a
104	(static or shared) library. Version 0.5 has autoconf and libtool support,	111	(static or shared) library. Version 0.5 has autoconf and libtool support,
105	and should run on many more platforms.	112	and should run on many more platforms. Version 0.6 has support for
		113	graphics.
106		114
107	High on the TODO list are input routines for Sketch, MBM and Record files.	115	High on the TODO list are input routines for Record files.
108	Sheet files will be next. I am running into some trouble understanding	116	Sheet files will be next. I am running into some trouble understanding
109	Data and Agenda files, but with a little luck, I'll figure it out after	117	Data and Agenda files, but with a little luck, I'll figure it out after
110	all. This is more long-term though.	118	all. This is more long-term though.
111	On the output side, I hope RTF will soon be done. This will allow most	119	On the output side, I hope RTF will soon be done. This will allow most
112	office tools to read the Psion files.	120	office tools to read the Psion files.

 Legend:



Removed from v.2
 


changed lines


 
Added in v.152
 Legend:



Removed from v.2
 


changed lines


 
Added in v.152
-Removed from v.2
+Added in v.152

frodo@frodo.looijaard.name	ViewVC Help
Powered by ViewVC 1.1.26