[Pulp-dev] sphinx theme for docs.pulpproject.org

Brian Bouterse bmbouter at redhat.com
Thu Oct 1 14:13:31 UTC 2020


On Thu, Oct 1, 2020 at 10:05 AM Quirin Pamp <pamp at atix.de> wrote:

> Of course these options are not mutually exclusive. We could decide on
> some theme (e.g.: pulp_ansible theme) and then have both pulpcore and all
> plugins consistently use that theme.
> I do quite like the sphinx_rtd_theme used by pulpcore, but that may just
> be because I am used to it.
>
> I guess my personal preferences would be:
>
> 1) All plugins and pulpcore use a custom pulp theme with pulp logo and a
> colour scheme like the one on https://pulpproject.org/
> 2) All plugins and pulpcore simply use the sphinx_rtd_theme (which strikes
> me as good enough, already widely in use, and similar to what readthedocs
> uses, so nobody needs to get used to anything totally new).
> 3) All plugins and pulpcore consistently use some other agreed upon theme.
>
> In the interest of "getting on with it" I would propose going with option
> (2) right now, and setting option (1) as a long term goal (perhaps open an
> issue for it).
>
This all sounds good to me.


> Kind regards,
> Quirin Pamp (quba42)
>
> ------------------------------
> *From:* Ina Panova <ipanova at redhat.com>
> *Sent:* 01 October 2020 15:00
> *To:* Dennis Kliban <dkliban at redhat.com>
> *Cc:* Quirin Pamp <pamp at atix.de>; Pulp-dev <pulp-dev at redhat.com>
> *Subject:* Re: [Pulp-dev] sphinx theme for docs.pulpproject.org
>
> my preference number 1 would be making plugins consistent with pulpcore.
> 2nd preference would be plup_ansibe theme.
>
> --------
> Regards,
>
> Ina Panova
> Senior Software Engineer| Pulp| Red Hat Inc.
>
> "Do not go where the path may lead,
>  go instead where there is no path and leave a trail."
>
>
> On Thu, Sep 24, 2020 at 4:14 PM Dennis Kliban <dkliban at redhat.com> wrote:
>
> On Thu, Sep 24, 2020 at 9:01 AM Quirin Pamp <pamp at atix.de> wrote:
>
> I don't have a strong opinion, but I feel like if we don't come up with
> anything better we could just  fall back to what the pulpcore docs are
> currently using.
>
> https://docs.pulpproject.org/pulpcore/
>
> https://github.com/pulp/pulpcore/blob/d31eb22453cd2d56b43ed884ec193fa166cafe62/docs/conf.py#L116
>
>
> +1 to making everything consistent with pulpcore.
>
>
> quba42
> ------------------------------
> *From:* pulp-dev-bounces at redhat.com <pulp-dev-bounces at redhat.com> on
> behalf of Dennis Kliban <dkliban at redhat.com>
> *Sent:* 24 September 2020 14:47
> *To:* Pulp-dev <pulp-dev at redhat.com>
> *Subject:* [Pulp-dev] sphinx theme for docs.pulpproject.org
>
> We are slowly rolling out plugin docs to docs.pulpproject.org. At this
> time pulp_file and pulp_ansible are the only plugins publishing their docs
> there. What I noticed is that they have completely different themes. We
> need to pick a single theme to be used by all plugins. Does anyone have
> suggestions for which theme that should be?
>
> https://docs.pulpproject.org/pulp_ansible/
> https://docs.pulpproject.org/pulp_file/
>
> _______________________________________________
> Pulp-dev mailing list
> Pulp-dev at redhat.com
> https://www.redhat.com/mailman/listinfo/pulp-dev
>
> _______________________________________________
> Pulp-dev mailing list
> Pulp-dev at redhat.com
> https://www.redhat.com/mailman/listinfo/pulp-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/pulp-dev/attachments/20201001/b3dd48bb/attachment.htm>


More information about the Pulp-dev mailing list