[PATCH 05 of 10 saem_ref] [doc] More content about skos and eac

Sylvain Thénault sylvain.thenault at logilab.fr
Tue Apr 11 13:48:22 CEST 2017


Le 11/04/2017 à 12:26, Denis Laxalde a écrit :
> Sylvain Thénault a écrit :
>>
>>
>> Le 11/04/2017 à 09:13, Denis Laxalde a écrit :
>>> Sylvain Thenault a écrit :
>>>> # HG changeset patch
>>>> # User Sylvain Thénault <sylvain.thenault at logilab.fr>
>>>> # Date 1491826635 -7200
>>>> #      Mon Apr 10 14:17:15 2017 +0200
>>>> # Node ID 45f72f19776612b2f7bcfeeafaee60bedeaf86d0
>>>> # Parent  92d7b8ce532ccea55a93df088eb0b78acf5e8d13
>>>> [doc] More content about skos and eac
>>>>
>>>> Notice eac was already referenced by the index but file wasn't in
>>>> there.
>>>>
>>>> diff --git a/doc/eac.rst b/doc/eac.rst
>>>> new file mode 100644
>>>> --- /dev/null
>>>> +++ b/doc/eac.rst
>>>> @@ -0,0 +1,28 @@
>>>> +=======
>>>> +EAC-CPF
>>>> +=======
>>>> +
>>>> +Le référentiel fournit une implémentation de EAC-CPF_ relativement
>>>> complète. Les notices d'autorités
>>>> +peuvent être créés ou importés directement dans l'interface web ou
>>>> bien importés en ligne de
>>>> +commande.
>>>> +
>>>> +.. section sur les balises supportées ou non
>>>> +.. include:: ../../cubicweb-eac/doc/supported.rst
>>>
>>> Meh. Couldn't we publish cubicweb-eac documentation on readthedocs and
>>> link
>>> it here instead? Or find another way than relative path to include
>>> it if
>>> possible.
>>
>> I want some kind of 'integrated' doc, and don't feel like dispatching it
>> in several readthedocs projects. Unfortunatly I've not yet found how to
>> avoid this hard-code path without implementing a custom directive.
>
> Perhaps a custom directive is the way to go. Something that relies on
> pkg_resources for instance. I don't know how expensive it is.
>
I've now a custom pkg-resources-include directive basically working but
hit another problem: "doc" directory of dependencies is not considered
as package's data and as such not available through the pkg_resources
API. It seems that the only way would be to move doc within the python
package directory. I don't like that but have no alternative idea. What
do you think ?

-- 
Sylvain Thénault, LOGILAB, Paris (01.45.32.03.12) - Toulouse (05.62.17.16.42)
Formations Python, Debian, Méth. Agiles: http://www.logilab.fr/formations
Développement logiciel sur mesure:       http://www.logilab.fr/services
CubicWeb, the semantic web framework:    http://www.cubicweb.org



More information about the saem-devel mailing list