Do you have smaller Python projects that only need a README file for

documentation? Want to host your README on Read The Docs?

sphinx-me is a BSD licensed tool that will create a Sphinx documentation shell
for your project and include the README file as the documentation index. It
handles extracting the required meta data such as the project name, author and
version from your project for use in your Sphinx docs.

Once you use sphinx-me to build your Sphinx docs, you can then add your project
to the Read The Docs site and have your project's README hosted with an
attractive Sphinx documentation theme.

Your README file should be in a reStructuredText compatible format.

WWW: https://github.com/stephenmcd/sphinx-me/
This commit is contained in:
Rene Ladan 2016-04-27 18:16:26 +00:00
parent e7f7731658
commit c47e1294f6
Notes: svn2git 2021-03-31 03:12:20 +00:00
svn path=/head/; revision=414125
4 changed files with 38 additions and 0 deletions

View File

@ -1289,6 +1289,7 @@
SUBDIR += py-sparqlwrapper
SUBDIR += py-sphinx
SUBDIR += py-sphinx-intl
SUBDIR += py-sphinx-me
SUBDIR += py-sphinx_numfig
SUBDIR += py-sphinx_rtd_theme
SUBDIR += py-sphinx_wikipedia

View File

@ -0,0 +1,20 @@
# Created by: René Ladan <rene@freebsd.org>
# $FreeBSD$
PORTNAME= sphinx-me
PORTVERSION= 0.3
CATEGORIES= textproc python
MASTER_SITES= CHEESESHOP
PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}
MAINTAINER= rene@FreeBSD.org
COMMENT= Wrap README-only projects in a dynamic Sphinx shell
LICENSE= BSD2CLAUSE
LICENSE_FILE= ${WRKSRC}/LICENSE
USES= python
USE_PYTHON= autoplist distutils
NO_ARCH= yes
.include <bsd.port.mk>

View File

@ -0,0 +1,2 @@
SHA256 (sphinx-me-0.3.tar.gz) = 98bef823a4053ca1ccbbe2322bd855a3c5e98797c50bcfeeb630fe11c47d5f1a
SIZE (sphinx-me-0.3.tar.gz) = 5682

View File

@ -0,0 +1,15 @@
Do you have smaller Python projects that only need a README file for
documentation? Want to host your README on Read The Docs?
sphinx-me is a BSD licensed tool that will create a Sphinx documentation shell
for your project and include the README file as the documentation index. It
handles extracting the required meta data such as the project name, author and
version from your project for use in your Sphinx docs.
Once you use sphinx-me to build your Sphinx docs, you can then add your project
to the Read The Docs site and have your project's README hosted with an
attractive Sphinx documentation theme.
Your README file should be in a reStructuredText compatible format.
WWW: https://github.com/stephenmcd/sphinx-me/