[gnome-doc-utils] [xml2po] Re-add basic.py replacing empty.py

[Claude Paroz <claudep src gnome org>]

commit b97421fba01984d2c583c54c4c032ae4b2f134f2
Author: Claude Paroz <claude 2xlibre net>
Date:   Wed Jun 24 23:26:52 2009 +0200

    [xml2po] Re-add basic.py replacing empty.py

 xml2po/modes/basic.py |   63 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 63 insertions(+), 0 deletions(-)
---
diff --git a/xml2po/modes/basic.py b/xml2po/modes/basic.py
new file mode 100644
index 0000000..c3081d8
--- /dev/null
+++ b/xml2po/modes/basic.py
@@ -0,0 +1,63 @@
+# Copyright (c) 2004, 2005, 2006 Danilo Segan <danilo gnome org>.
+#
+# This file is part of xml2po.
+#
+# xml2po 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.
+#
+# xml2po 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 xml2po; if not, write to the Free Software Foundation, Inc.,
+# 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+
+# Abstract class; inherit from it to construct other special-handling classes
+#
+
+class basicXmlMode:
+    """Abstract class for special handling of document types."""
+    def getIgnoredTags(self):
+        "Returns array of tags to be ignored."
+        return []
+
+    def getFinalTags(self):
+        "Returns array of tags to be considered 'final'."
+        return []
+
+    def getSpacePreserveTags(self):
+        "Returns array of tags in which spaces are to be preserved."
+        return []
+
+    def getTreatedAttributes(self):
+        "Returns array of tag attributes which content is to be translated"
+        return []
+
+    def preProcessXml(self, doc, msg):
+        "Preprocess a document and perhaps adds some messages."
+        pass
+
+    def postProcessXmlTranslation(self, doc, language, translators):
+        """Sets a language and translators in "doc" tree.
+        
+        "translators" is a string consisted of translator credits.
+        "language" is a simple string.
+        "doc" is a libxml2.xmlDoc instance."""
+        pass
+
+    def getStringForTranslators(self):
+        """Returns None or a string to be added to PO files.
+
+        Common example is 'translator-credits'."""
+        return None
+
+    def getCommentForTranslators(self):
+        """Returns a comment to be added next to string for crediting translators.
+
+        It should explain the format of the string provided by getStringForTranslators()."""
+        return None