Bug#931548: Migration to Sphinx
Package: src:developers-reference
Version: 3.4.25
Severity: wishlist
Tags: patch
Patch is provided as rest8 branch.
https://salsa.debian.org/debian/developers-reference/tree/rest8
├── debian
│ ├── changelog
│ ├── control
│ ├── copyright
│ ├── developers-reference-de.doc-base
│ ├── developers-reference-de.docs
│ ├── developers-reference.doc-base
│ ├── developers-reference.docs
│ ├── developers-reference-fr.doc-base
│ ├── developers-reference-fr.docs
│ ├── developers-reference-it.doc-base
│ ├── developers-reference-it.docs
│ ├── developers-reference-ja.doc-base
│ ├── developers-reference-ja.docs
│ ├── developers-reference-ru.doc-base
│ ├── developers-reference-ru.docs
│ ├── rules
│ ├── source
│ │ └── format
│ ├── tocsubstvars
│ └── TODO
├── Makefile
├── README.contributing
├── source
│ ├── best-pkging-practices.rst
│ ├── beyond-pkging.rst
│ ├── conf.py
│ ├── developer-duties.rst
│ ├── index.rst
│ ├── l10n.rst
│ ├── locales
│ │ ├── de
│ │ │ └── LC_MESSAGES
│ │ │ ├── best-pkging-practices.po
│ │ │ ├── beyond-pkging.po
│ │ │ ├── developer-duties.po
│ │ │ ├── index.po
│ │ │ ├── l10n.po
│ │ │ ├── new-maintainer.po
│ │ │ ├── pkgs.po
│ │ │ ├── resources.po
│ │ │ ├── scope.po
│ │ │ └── tools.po
│ │ ├── fr
│ │ │ └── LC_MESSAGES
│ │ │ ├── best-pkging-practices.po
│ │ │ ├── beyond-pkging.po
│ │ │ ├── developer-duties.po
│ │ │ ├── index.po
│ │ │ ├── l10n.po
│ │ │ ├── new-maintainer.po
│ │ │ ├── pkgs.po
│ │ │ ├── resources.po
│ │ │ ├── scope.po
│ │ │ └── tools.po
│ │ ├── it
│ │ │ └── LC_MESSAGES
│ │ │ ├── best-pkging-practices.po
│ │ │ ├── beyond-pkging.po
│ │ │ ├── developer-duties.po
│ │ │ ├── index.po
│ │ │ ├── l10n.po
│ │ │ ├── new-maintainer.po
│ │ │ ├── pkgs.po
│ │ │ ├── resources.po
│ │ │ ├── scope.po
│ │ │ └── tools.po
│ │ ├── ja
│ │ │ └── LC_MESSAGES
│ │ │ ├── best-pkging-practices.po
│ │ │ ├── beyond-pkging.po
│ │ │ ├── developer-duties.po
│ │ │ ├── index.po
│ │ │ ├── l10n.po
│ │ │ ├── new-maintainer.po
│ │ │ ├── pkgs.po
│ │ │ ├── resources.po
│ │ │ ├── scope.po
│ │ │ └── tools.po
│ │ └── ru
│ │ └── LC_MESSAGES
│ │ ├── best-pkging-practices.po
│ │ ├── beyond-pkging.po
│ │ ├── developer-duties.po
│ │ ├── index.po
│ │ ├── l10n.po
│ │ ├── new-maintainer.po
│ │ ├── pkgs.po
│ │ ├── resources.po
│ │ ├── scope.po
│ │ └── tools.po
│ ├── new-maintainer.rst
│ ├── pkgs.rst
│ ├── resources.rst
│ ├── scope.rst
│ ├── _static
│ └── tools.rst
└── sphinx-multi
You can build HTML and PDF with "make".
debian/* still needs to be polished as of this posting.
The conversion process is completely recorded in the history. If main branch
is update, we can rebase most of rest8 and do the operation as in the commit
message to get conversion for the updated master if needed.
Maybe, now I think Sphinx expert can take over to get proper packaging.
Osamu
-- System Information:
Debian Release: 10.0
APT prefers stable
APT policy: (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.19.0-5-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Reply to: