Skip to content
Snippets Groups Projects
Commit 93591380 authored by David Douard's avatar David Douard
Browse files

docs: include the README file in the main index page

Convert README from markdown to ReST to make it embeddable in
docs/index.rst
parent 509f2fce
No related branches found
No related tags found
Loading
swh-model Software Heritage - Data model
========= ==============================
Implementation of the Data model of the Software Heritage project, used to Implementation of the Data model of the Software Heritage project, used to
archive source code artifacts. archive source code artifacts.
This module defines the notion of SoftWare Heritage persistent IDentifiers This module defines the notion of SoftWare Hash persistent IDentifiers
(SWHIDs) and provides tools to compute them: (SWHIDs) and provides tools to compute them:
```sh .. code-block:: shell
$ swh-identify fork.c kmod.c sched/deadline.c $ swh-identify fork.c kmod.c sched/deadline.c
swh:1:cnt:2e391c754ae730bd2d8520c2ab497c403220c6e3 fork.c swh:1:cnt:2e391c754ae730bd2d8520c2ab497c403220c6e3 fork.c
swh:1:cnt:0277d1216f80ae1adeed84a686ed34c9b2931fc2 kmod.c swh:1:cnt:0277d1216f80ae1adeed84a686ed34c9b2931fc2 kmod.c
...@@ -15,4 +16,4 @@ This module defines the notion of SoftWare Heritage persistent IDentifiers ...@@ -15,4 +16,4 @@ This module defines the notion of SoftWare Heritage persistent IDentifiers
$ swh-identify --no-filename /usr/src/linux/kernel/ $ swh-identify --no-filename /usr/src/linux/kernel/
swh:1:dir:f9f858a48d663b3809c9e2f336412717496202ab swh:1:dir:f9f858a48d663b3809c9e2f336412717496202ab
```
.. _swh-model: .. _swh-model:
Software Heritage - Data model .. include:: README.rst
==============================
Implementation of the :ref:`data-model` to archive source code artifacts.
.. toctree:: .. toctree::
:caption: Overview: :caption: Overview:
......
...@@ -12,7 +12,7 @@ from setuptools import find_packages, setup ...@@ -12,7 +12,7 @@ from setuptools import find_packages, setup
here = path.abspath(path.dirname(__file__)) here = path.abspath(path.dirname(__file__))
# Get the long description from the README file # Get the long description from the README file
with open(path.join(here, "README.md"), encoding="utf-8") as f: with open(path.join(here, "README.rst"), encoding="utf-8") as f:
long_description = f.read() long_description = f.read()
...@@ -39,7 +39,7 @@ setup( ...@@ -39,7 +39,7 @@ setup(
name="swh.model", name="swh.model",
description="Software Heritage data model", description="Software Heritage data model",
long_description=long_description, long_description=long_description,
long_description_content_type="text/markdown", long_description_content_type="text/x-rst",
python_requires=">=3.7", python_requires=">=3.7",
author="Software Heritage developers", author="Software Heritage developers",
author_email="swh-devel@inria.fr", author_email="swh-devel@inria.fr",
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment