Commits

Marcin Kasperski  committed 8d7c0fd

A few extra remarks.

  • Participants
  • Parent commits c35a3d2

Comments (0)

Files changed (1)

File serendipity2disqus.py

   * Edit database connection details below and other config elements below
 
   * Execute
-  
 
     python /path/to/serendipity2disqus.py  output.xml
 
     If everything worked right, this will create xml
     file suitable for disqus import.
 
+  * Validate
+
+    I recommend validating the file before importing, in case some syntax errors creep in.
+    For example:
+
+         xmlstarlet val output.xml
+
+  * Import
+
+    Use Disqus Import/Export form to import the XML file.
+
 Important notes:
 
   * Entries numerical id's are used as disqus thread identifiers.
     way to distinguish trackbacks and pingbacks from normal comments,
     I have no clue how are they to be imported)
 
+  * Big comment files may fail to import or take long time to do it.
+    If your file exceeds a few megabytes, consider splitting it into a
+    few smaller parts (either by patching this script, or by editing
+    the XML).  Disqus properly handles many successive imports as long
+    as there are no duplicates and thread replies follow thread
+    origins.
+
 """
 
 ###########################################################################