From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id E24878E56 for ; Sun, 1 Nov 2015 17:41:56 +0100 (CET) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga101.jf.intel.com with ESMTP; 01 Nov 2015 08:41:55 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.20,229,1444719600"; d="scan'208";a="840074847" Received: from irsmsx105.ger.corp.intel.com ([163.33.3.28]) by orsmga002.jf.intel.com with ESMTP; 01 Nov 2015 08:41:53 -0800 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.116]) by irsmsx105.ger.corp.intel.com ([169.254.7.75]) with mapi id 14.03.0248.002; Sun, 1 Nov 2015 16:41:52 +0000 From: "Mcnamara, John" To: 'Thomas Monjalon' Thread-Topic: [dpdk-dev] [PATCH v2] doc: change sphinx theme to the read the docs theme Thread-Index: AQHRC+SJ/uT9n5Gfw0e7H/HgR05VAJ593smAgAYj9AA= Date: Sun, 1 Nov 2015 16:41:52 +0000 Message-ID: References: <1445340689-32625-1-git-send-email-john.mcnamara@intel.com> <1445420342-25227-1-git-send-email-john.mcnamara@intel.com> <2449554.9X2Y58lndV@xps13> In-Reply-To: <2449554.9X2Y58lndV@xps13> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [163.33.239.180] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Cc: "dev@dpdk.org" Subject: Re: [dpdk-dev] [PATCH v2] doc: change sphinx theme to the read the docs theme X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 01 Nov 2015 16:41:57 -0000 > -----Original Message----- > From: Thomas Monjalon [mailto:thomas.monjalon@6wind.com] > Sent: Monday, October 26, 2015 2:34 PM > To: Mcnamara, John > Cc: dev@dpdk.org > Subject: Re: [dpdk-dev] [PATCH v2] doc: change sphinx theme to the read > the docs theme >=20 > 2015-10-21 10:39, John McNamara: > > Change the Sphinx default theme from "alabaster" to the ReadTheDocs > > theme. See for example: > > > > http://dpdk.readthedocs.org/en/latest/ > > > > This looks better for technical documentation and in particular it has > > a 80 char wide verbatim block rendering. >=20 > Yes it is a clean theme. > It would be nice to add the DPDK logo somewhere. Hi, I'll submit a V3 with a logo for the html and pdf docs. Note, the SVG logos are quite big (2 are required) and converting them to p= df for the Latex pdf docs requires another addition to the makefiles. This = is a case where the patch would be smaller and simpler with PNG files and w= here the images are unlikely to require editing. > > Also turn off option for distracting Html mouseover permalinks. > [...] > > +html_add_permalinks =3D "" >=20 > I think the permalinks are very useful to point a specific doc chapter to > someone else. It is just as easy to get a link to a subsection from the index. The permal= inks are distracting because they blink on and off when scrolling through t= he docs. Also, I doubt more than a handful of people will know what the per= malinks in the Html docs are. Anyway, I'll remove this part from the patch and submit it separately. If t= here is any support for it the patch can be applied, if not then you can re= ject it. John. --=20