Re: [PATCH 0/6] docs: some refactoring and new docs about RPM deployment

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Nov 13, 2019 at 02:53:21PM +0100, Kashyap Chamarthy wrote:
> On Mon, Nov 11, 2019 at 02:39:35PM +0000, Daniel P. Berrangé wrote:
> 
> [...]
> 
>  
> > NB writing content is RST is independent of eliminating XSLT as the
> > templating system. Elimination oif XSLT depends what templating
> > system we use, either Sphinx or Pelican - I've not delved into it
> > to figure out which is better,
> 
> FWIW, Sphinx seems to be the "preferred" choice for Linux[*], QEMU.
> (OpenStack upstream also uses it heavily.)

Yep, but there's a difference for libvirt's needs. IIUC those projects are
all building the docs into a manual. Libvirt is building its docs into a
website with a series of pages. I've not investigated in a lot of detail,
but my first impressions are that Pelican is better suited for building
websites, while Sphinx is better suited for building manuals. Both use
RST as their input though, so the decision of which to use mostly impacts
the way we later replace the XSLT with a new page template, so I've not
spent much time on it yet.


Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list




[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]

  Powered by Linux