Markdown Monster
Possible to use SPINX theme - ReadTheDocs?
Gravatar is a globally recognized avatar based on your email address. re: Possible to use SPINX theme - ReadTheDocs?
  Rick Strahl
  TahorSuiJuris
  Mar 11, 2019 @ 08:11pm

Yes you can create custom themes using CSS to match whatever styling:

Customizing Preview Themes

There are two ways to go about this:

  • Duplicate the CSS from the theme
  • Link the online CSS directly in the page template

I'd try the latter first to see whether that works, and if it does then maybe try to pull down the necessary CSS local so the theme can work offline.

+++ Rick ---

Gravatar is a globally recognized avatar based on your email address. re: Possible to use SPINX theme - ReadTheDocs?
  TahorSuiJuris
  Rick Strahl
  Mar 11, 2019 @ 08:17pm

I read that part before. That is for the editor, not the output. I reason I asked is both MKDocs and Markdown Monster publish direct to the server. I cannot use the Sphinx them, at least I have not found a way yet to have the power of Markdown Monster with the end result being a published product like MKDocs - ReadTheDoc SPHINX theme, as the published result.

Gravatar is a globally recognized avatar based on your email address. re: Possible to use SPINX theme - ReadTheDocs?
  Rick Strahl
  TahorSuiJuris
  Mar 11, 2019 @ 09:12pm

Sorry I'm not sure what you're asking exactly.

Markdown contains no CSS of styling - it just generates HTML output and the output handling is the responsibility of the host site that hosts the HTML. Aren't you publishing MD documents to ReadTheDocs and it renders the markdown using its own styling?

MM can create fully self contained output for individual documents using Save As and save as HTML Package which contains all dependencies localized. But that gets very large.

Here's more info on that:

Save Markdown as HTML Output

Using that approach - you can create your own theme, then Save As HTML in a folder which gives you the HTML output plus all the styling and bits. You can then save any other documents there as HTML and they should all use the same style links etc.

I don't think this addresses what you're trying to do but maybe this clarifies what is possible and can help clarify what you actually want to do.

Really what you're asking though sounds more like you're trying to build a documentation solution that bypasses some central engine that would normally manage the styling (ie. ReadTheDocs, DocFx, KavaDocs etc.).

+++ Rick ---

© 1996-2024