e297b1a477
Makes it easier to contribute and accept translations.
Does add a new dependency on installation from source, polib. This is
not made mandatory because not all users will want translations.
polib has no further dependencies and can be installed anywhere
LinkChecker can, using pip too.
Add release process step to check polib is installed
The Wheel still includes translations. Recommend install from PyPI in
the README.
Translations were being compiled in setup.py until 2014, using a bundled
copy of msgfmt.py.
9c3739f1c ("Replace msgfmt.py with local tools.", 2014-09-08)
2.3 KiB
Developing LinkChecker
The following steps describe how to compile LinkChecker from source on various platforms.
This is a technical document, if you are looking for ways to participate in the community, you should rather look into contributing.
Requirements
On Mac OS X systems, using MacPorts, Fink or homebrew for software installation is recommended.
-
Install Python >= 2.7.2 from http://www.python.org/
-
On Windows only, install the Windows SDK http://msdn.microsoft.com/de-de/windows/bb980924
-
On Windows only, download and install the Microsoft Visual C++ 2008 runtime from http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en
-
Optional, used for Virus checking: ClamAv for Unix from http://www.clamav.net/lang/en/download/ or for Windows from http://www.sosdg.org/clamav-win32/
-
Optional, for displaying country codes: Pygeoip from http://code.google.com/p/pygeoip/
Setup for Unix/Linux
Execute make localbuild to compile a local version and execute
./linkchecker.
Execute make test to run the unittest suite.
Execute make dist to build a distributable source package.
Setup for Mac OS X
Execute make localbuild to compile a local version and execute
./linkchecker.
Execute make test to run the unittest suite.
Execute make app to build a distributable source package.
Setup for Windows
Execute windows\build.bat to build a local version.
Execute windows\test.bat to run the unittest suite.
Execute windows\dist.bat to build a binary installer.
Release process
-
check whether updated translations need committing (
make locale; make -C doc locale; make -C doc man) -
bump AppVersion in
setup.py, editchangelog.txt, and if applicable the copyright date inlinkcheck/configuration/__init__.py -
confirm tests have passed
-
submit a pull request
-
create a new git clone
-
check Python polib package is installed
-
build Python distribution files (
setup.py sdist bdist_wheel) -
check distribution files (
twine check dist/*) and upload to PyPI (twine upload dist/*) -
create release (vX.Y.Z) on GitHub (GitHub creates the .tar.gz and .zip archives)
-
increment AppVersion to vX.Y.Z+1.dev0