it33
(Ian Tien)
November 17, 2015, 2:51pm
1
For some time now we’ve been trying to figure out a way to render Mattermost documentation so that it:
Supports export to PDF
Supports localization
Supports includes (e.g. write the SMTP install instructions once and include it in all install guides without copy and pasting everywhere).
Doesn’t require us to mangle our folders and naming conventions
Supports table of contents
Supports search
Right now, no matter how hard to try to find a markdown solution, it seems Sphinx is the only framework that supports what we need.
Any suggestions from the community?
gusgonnet
(Gustavo Gonnet)
October 6, 2016, 6:02pm
2
Hi,
By looking at the docs today I see you guys switched to Sphinx. How is it going so far in your opinion?
I have a project at work that has similar requirements and was wondering about your experience with it.
thanks!
Gustavo.
it33
(Ian Tien)
October 8, 2016, 4:34am
3
It’s good,
If you go with Sphinx and want PDF export, I’d recommend using .rst instead of .md from the start.
We started with .md and it just doesn’t have the support needed for tables and notes, etc. that we need for PDF export.
gusgonnet
(Gustavo Gonnet)
October 11, 2016, 12:11pm
4
great tip, will look into it.
thank you,
Gustavo.