## smconv_pl v.0.0.3alpha

# project page: smconv_pl.sf.net

# Sergey Khokhlov <turain@users.sf.net>
# 20050417


# ------------------------------------------------------------------------------
## License

#  This program is free software; you can redistribute it and/or
#  modify it under the terms of the GNU General Public License
#  as published by the Free Software Foundation; either version 2
#  of the License, or (at your option) any later version.
#  This program is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
#  You should have received a copy of the GNU General Public License
#  along with this program; if not, write to the Free Software
#  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA


# ------------------------------------------------------------------------------
## Attention

   As you can see - this is first _experimental_ release,  so you can  use it at
your own risk  without any warranties.  If you decide  to try it,  please,  make
backups very often.


# ------------------------------------------------------------------------------
## Description

    This  is simple  'SuperMemo for  Palm PDB'  <-> 'XML'  converter.  smconv_pl
written  on portable (?) perl  and can be used at any system running perl (check
INSTALL for further details).

    XML format is developed with smconv_pl, so it is not a SuperMemo XML format.
If you interested in conversion smconv_pl XML <-> SuperMemo XML you need to know
'how to convert learning data?' - I do not know :(

    In 'transform' directory  you  can  find tools  for  transforming  smconv_pl
'XML' <-> 'CSV', so  you can  use any  spreadsheet  editor  to edit  your  smemo
databases. Also, you can find 'XML' -> 'HTML' xsl transform there.


# ------------------------------------------------------------------------------
## Problems?

    If you have problems with using this software - copy your pdb-file to 'test'
dir and try to execute some test scripts on it:
	cd test
	scripts/smconv_palm_test_rw_1.bat "your pdb"
	scripts/smconv_palm_test_rw_2.bat "your pdb"
	scripts/smconv_palm_test_rw_3.bat "your pdb"
	scripts/smconv_palm_test_rw_4.bat "your pdb"
	scripts/smconv_palm_test_mega.bat "your pdb"

    If you have problems converting XML to PDB - check it against DTD.

    If you do what you can and 'no hope' - send e-mail to me, maybe i can help.

# ------------------------------------------------------------------------------
## Not a problems
 - do something with nonreadable characters in XML (like \x17\x18)
 = all nonreadable charcters can (?) be fixed with specific expat enc-map