I'm trying to use XmlDocMarkdown with a Hugo site (defined here: https://github.com/mysql-net/MySqlConnector/tree/master/docs)
So far, I've gotten the best results with this command line:
xmldocmd --front-matter .\docs\front-matter.yml --clean --namespace-pages --permalink pretty .\src\MySqlConnector\bin\Release\netcoreapp3.0\MySqlConnector.dll docs\content\api\MySqlConnector\
However, the links in the generated files aren't correct, as they assume that the page will be served from /api/MySqlConnector/MySqlConnectorAssembly.html instead of /api/MySqlConnector/MySqlConnectorAssembly/. Thus, a relative link goes to /api/MySqlConnector/MySqlConnectorAssembly/MySql.Data.MySqlClient/MySqlConnectionType (which 404s) when it should be /api/MySqlConnector/MySql.Data.MySqlClient/MySqlConnectionType/.
I've fixed the generated links in this commit, although I suspect there would be a more elegant way to do it: bgrainger@7e572ce.
This may relate to #77.
I'm trying to use XmlDocMarkdown with a Hugo site (defined here: https://github.com/mysql-net/MySqlConnector/tree/master/docs)
So far, I've gotten the best results with this command line:
However, the links in the generated files aren't correct, as they assume that the page will be served from
/api/MySqlConnector/MySqlConnectorAssembly.htmlinstead of/api/MySqlConnector/MySqlConnectorAssembly/. Thus, a relative link goes to/api/MySqlConnector/MySqlConnectorAssembly/MySql.Data.MySqlClient/MySqlConnectionType(which 404s) when it should be/api/MySqlConnector/MySql.Data.MySqlClient/MySqlConnectionType/.I've fixed the generated links in this commit, although I suspect there would be a more elegant way to do it: bgrainger@7e572ce.
This may relate to #77.