convert .doc to .rst

[Renato Pontefice]

Hi, I'm a very new user of sphinx. 

I need to convert a bunch of .doc (MS word) made by MS word, to .rst.

This is, to start using sphinx (and a wiki) to create user doc to our procedure sw.

I do not find the way to do that. Isw it possible?

TIA

[ChrisD]

 

I need to convert a bunch of .doc (MS word) made by MS word, to .rst.

Pandoc (http://pandoc.org/) can convert docx to rst. I do not know of a tool to convert the older doc files to rst, but there are a number of tools for converting doc to docx, and then you could use Pandoc to convert to rst.

I haven't done this myself so don't know how good the conversion would be...

Chris

[Renato Pontefice]

with pandoc I do not find the way to convert docx to rst (just rst to docx) :-(

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To post to this group, send email to sphinx...@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

[Martin Bless]

Hello Renato,

In the TYPO3 community we had and have a lot of openoffice documents. I've written ("hacked"!) a set of tools to convert those documents. That's the good news: yes, it is possible. The bad news: I didn't find time yet to create documentation about the howto yet.

Here is a toolchain and how it works:

• Get my set of tools, the "T3PythonDocBuilder-Package" from https://github.com/marble/T3PythonDocBuilderPackage
• Save your Word document as "manual.sxw" in Openoffice format.
• Run "python t3pdb_sxw2html.py
• You probably need LibreOffice (or OpenOffice), Python, and "tidy" for this.
• The toolchain lets LibreOffice convert the "manual.sxw" to an xhtml document, fixes it using tidy, creates a reST file from it and extracts the images. Then it build HTML output from the reST files.
• Additionally a (TYPO3-like) Sphinx documentation project is generated from the reST file. Afterwards a Sphinx-build is run.
• As a final result this is what you get:
  https://docs.typo3.org/typo3cms/extensions/community/0.0.0/
  
• from this input:
  https://docs.typo3.org/typo3cms/extensions/community/0.0.0/manual.sxw
  
  

Maybe this works as well (and would be much easier):

• Save your Word document as VALID xhtml file.
• Run: "python ooxhtml2rst.py"

The basic idea of my toolset is that we take the xhtml format that OpenOffice writes as input for my converter.

Good luck and Leave a note at https://github.com/marble/T3PythonDocBuilderPackage/issues if you can make it work!

Martin

--

http://mbless.de

• 
  
  
  

D

[renato]

Hi Martin

how do I can save in XHTML?

From MS Word or from LibreOffice?

I do that exporting in xhtml by LO 5.x (on linux pc), but what I obtained, is a dirty text file with many xml tags...

Do I made something wrong?

Renato

--

[Michael F. Peintinger]

Hi Renato,

here's a short blog entry on how I do it:

http://peintinger.com/?p=365

I hope this helps!

Cheers

Michael

[ChrisD]

It works for me. :-)

I have no problems using pandoc to convert docx to html or rst.. I'm using the latest pandoc version 1.16.0.2.

Chris

[ChrisD]

I posted this previously but it doesn't appear to have made it out to the group. I'll try again...

[Renato Pontefice]

Great! I've done all the chain that Michael describe in his tutorial. I've just two prob:

One image inside a table is not shown,  and another "in line" with text.. Do I have to check the .rst? I mean: the prob could be in the conversion? or what?

Thanks

Renato