You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Hi,
I am trying to move from an old word based documentation to an rst based documentation. First I tried word to rst, but i figured it is better to exported the word document as html and then convert html to rst. I dont know much about html, but I try my best to explain the problem.
The html file is large (27k+ lines) and there are 1000+ cross references like the one below:
I use the following command to convert html to rst: pandoc -f html -t rst --section-divs --reference-links --standalone --wrap=none my_documentation.htm -o ../docs/source/tmp.rst
In tmp.rst the definition appears as
StartPosition real real real
and the reference later in the text looks like
`StartPosition`_
On the bottom of the rst file I found a list of all reference and one line like this:
.. _StartPosition: #w_startposition
However, neither _StartPosition nor w_startposition appear in the rst file. When I use sphinx to build the html, the cross references dont work. Does anyone know what to do? Any help is appreciated! :)
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
-
Hi,
I am trying to move from an old word based documentation to an rst based documentation. First I tried word to rst, but i figured it is better to exported the word document as html and then convert html to rst. I dont know much about html, but I try my best to explain the problem.
The html file is large (27k+ lines) and there are 1000+ cross references like the one below:
which is later referenced in the text like this:
I use the following command to convert html to rst:
pandoc -f html -t rst --section-divs --reference-links --standalone --wrap=none my_documentation.htm -o ../docs/source/tmp.rst
In
tmp.rst
the definition appears asand the reference later in the text looks like
On the bottom of the rst file I found a list of all reference and one line like this:
However, neither
_StartPosition
norw_startposition
appear in the rst file. When I use sphinx to build the html, the cross references dont work. Does anyone know what to do? Any help is appreciated! :)Beta Was this translation helpful? Give feedback.
All reactions