]> git.phdru.name Git - extfs.d.git/blob - xml-ANNOUNCE
218346dd40d0728ae2183927690454e17cf46c47
[extfs.d.git] / xml-ANNOUNCE
1 XML Virtual FileSystem for Midnight Commander
2
3
4 WHAT IS IT
5    View an XML file in Midnight Commander as a filesystem.
6
7
8 WHAT'S NEW in version 1.0.1 (2013-11-24)
9    Fixed a few minor bugs.
10
11 WHAT'S NEW in version 1.0.0 (2013-11-23)
12    With lxml.etree-based implementation show only child namespaces
13    (calculated as combined namespaces minus parent's namespaces).
14
15 WHAT'S NEW in version 0.6.0 (2013-11-22)
16    Refactored _list() and attrs2text() to be completely generic.
17
18 WHAT'S NEW in version 0.5.0 (2013-11-19)
19    Added lxml.etree-based implementation.
20
21 WHAT'S NEW in version 0.4.0 (2013-11-19)
22    Added ElementTree-based implementation.
23
24 WHAT'S NEW in version 0.3.0 (2013-11-16)
25    Initial release. Implementation based on minidom.
26
27
28 WHERE TO GET
29    Home page: http://phdru.name/Software/mc/xml.html
30     git clone http://git.phdru.name/extfs.d.git
31      git clone git://git.phdru.name/extfs.d.git
32
33    Installation instructions: http://phdru.name/Software/mc/INSTALL.html
34
35
36 The VFS represents tags as directories; the directories are numbered to
37 distinguish tags with the same name; numbering also helps to sort tags by their
38 order in XML instead of sorting them by name. Attributes, text nodes and
39 comments are represented as text files; attributes are shown in a file named
40 "attributes", attributes are listed in the file as name=value lines (I
41 deliberately ignore a small chance of newline characters in values); names and
42 values are reencoded to the console encoding. Text nodes and comments are
43 collected in a file named "text", stripped and reencoded. The filesystem is
44 read-only.
45
46 Implementation based on minidom doesn't understand namespaces, it just shows
47 them among other attributes. ElementTree-based implementation doesn't show
48 namespaces at all. Implementation based on lxml.etree shows namespaces in a
49 separate file "namespaces".
50
51 It is useful to have a top-down view on an XML structure but it's especially
52 convenient to extract text values from tags. One can get, for example, a
53 base64-encoded image - just walk down the VFS to the tag's directory and copy
54 its text file to a real file.
55
56 The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
57
58
59 AUTHOR
60    Oleg Broytman <phd@phdru.name>
61
62 COPYRIGHT
63    Copyright (C) 2013 PhiloSoft Design
64
65 LICENSE
66    GPL