From 17b59e1ced64fe4994c175ad4dde1ac21f742102 Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Wed, 31 May 2023 06:26:55 +0000 Subject: automatic import of python-sphinx-selective-exclude --- .gitignore | 1 + python-sphinx-selective-exclude.spec | 129 +++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 131 insertions(+) create mode 100644 python-sphinx-selective-exclude.spec create mode 100644 sources diff --git a/.gitignore b/.gitignore index e69de29..25c8316 100644 --- a/.gitignore +++ b/.gitignore @@ -0,0 +1 @@ +/sphinx_selective_exclude-1.0.3.tar.gz diff --git a/python-sphinx-selective-exclude.spec b/python-sphinx-selective-exclude.spec new file mode 100644 index 0000000..826a624 --- /dev/null +++ b/python-sphinx-selective-exclude.spec @@ -0,0 +1,129 @@ +%global _empty_manifest_terminate_build 0 +Name: python-sphinx-selective-exclude +Version: 1.0.3 +Release: 1 +Summary: Sphinx eager ".. only::" directive and other selective rendition extensions +License: MIT license +URL: https://github.com/pfalcon/sphinx_selective_exclude +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/c2/07/4d6cb9dbe1b06be5caa21eed9813ac1e5ca5b29f3728be1d5e52f1cd7267/sphinx_selective_exclude-1.0.3.tar.gz +BuildArch: noarch + + +%description +Project home page: https://github.com/pfalcon/sphinx_selective_exclude +The implementation of ".. only::" directive in Sphinx documentation +generation tool is known to violate principles of least user surprise +and user expectations in general. Instead of excluding content early +in the pipeline (pre-processor style), Sphinx defers exclusion until +output phase, and what's the worst, various stages processing ignore +"only" blocks and their exclusion status, so they may leak unexpected +information into ToC, indexes, etc. +There's multiple issues submitted upstream on this matter: +* https://github.com/sphinx-doc/sphinx/issues/2150 +* https://github.com/sphinx-doc/sphinx/issues/1717 +* https://github.com/sphinx-doc/sphinx/issues/1488 +* etc. +They are largely ignored by Sphinx maintainers. +This projects tries to rectify situation on users' side. It actually +changes the way Sphinx processes "only" directive, but does this +without forking the project, and instead is made as a standard +Sphinx extension, which a user may add to their documentation config. +Unlike normal extensions, extensions provided in this package +monkey-patch Sphinx core to work in a way expected by users. + +%package -n python3-sphinx-selective-exclude +Summary: Sphinx eager ".. only::" directive and other selective rendition extensions +Provides: python-sphinx-selective-exclude +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-sphinx-selective-exclude +Project home page: https://github.com/pfalcon/sphinx_selective_exclude +The implementation of ".. only::" directive in Sphinx documentation +generation tool is known to violate principles of least user surprise +and user expectations in general. Instead of excluding content early +in the pipeline (pre-processor style), Sphinx defers exclusion until +output phase, and what's the worst, various stages processing ignore +"only" blocks and their exclusion status, so they may leak unexpected +information into ToC, indexes, etc. +There's multiple issues submitted upstream on this matter: +* https://github.com/sphinx-doc/sphinx/issues/2150 +* https://github.com/sphinx-doc/sphinx/issues/1717 +* https://github.com/sphinx-doc/sphinx/issues/1488 +* etc. +They are largely ignored by Sphinx maintainers. +This projects tries to rectify situation on users' side. It actually +changes the way Sphinx processes "only" directive, but does this +without forking the project, and instead is made as a standard +Sphinx extension, which a user may add to their documentation config. +Unlike normal extensions, extensions provided in this package +monkey-patch Sphinx core to work in a way expected by users. + +%package help +Summary: Development documents and examples for sphinx-selective-exclude +Provides: python3-sphinx-selective-exclude-doc +%description help +Project home page: https://github.com/pfalcon/sphinx_selective_exclude +The implementation of ".. only::" directive in Sphinx documentation +generation tool is known to violate principles of least user surprise +and user expectations in general. Instead of excluding content early +in the pipeline (pre-processor style), Sphinx defers exclusion until +output phase, and what's the worst, various stages processing ignore +"only" blocks and their exclusion status, so they may leak unexpected +information into ToC, indexes, etc. +There's multiple issues submitted upstream on this matter: +* https://github.com/sphinx-doc/sphinx/issues/2150 +* https://github.com/sphinx-doc/sphinx/issues/1717 +* https://github.com/sphinx-doc/sphinx/issues/1488 +* etc. +They are largely ignored by Sphinx maintainers. +This projects tries to rectify situation on users' side. It actually +changes the way Sphinx processes "only" directive, but does this +without forking the project, and instead is made as a standard +Sphinx extension, which a user may add to their documentation config. +Unlike normal extensions, extensions provided in this package +monkey-patch Sphinx core to work in a way expected by users. + +%prep +%autosetup -n sphinx-selective-exclude-1.0.3 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-sphinx-selective-exclude -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 31 2023 Python_Bot - 1.0.3-1 +- Package Spec generated diff --git a/sources b/sources new file mode 100644 index 0000000..aff0252 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +c17ba9ff85e5062a9e985b98b64b1b09 sphinx_selective_exclude-1.0.3.tar.gz -- cgit v1.2.3