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:
parent
e7f7731658
commit
c47e1294f6
Notes:
svn2git
2021-03-31 03:12:20 +00:00
svn path=/head/; revision=414125
@ -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
|
||||
|
20
textproc/py-sphinx-me/Makefile
Normal file
20
textproc/py-sphinx-me/Makefile
Normal 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>
|
2
textproc/py-sphinx-me/distinfo
Normal file
2
textproc/py-sphinx-me/distinfo
Normal file
@ -0,0 +1,2 @@
|
||||
SHA256 (sphinx-me-0.3.tar.gz) = 98bef823a4053ca1ccbbe2322bd855a3c5e98797c50bcfeeb630fe11c47d5f1a
|
||||
SIZE (sphinx-me-0.3.tar.gz) = 5682
|
15
textproc/py-sphinx-me/pkg-descr
Normal file
15
textproc/py-sphinx-me/pkg-descr
Normal 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/
|
Loading…
Reference in New Issue
Block a user