[OSGeoLive] Building the OSGeoLive docs on Windows

[Seth G]

Hi,

The build steps for OSGeo Live worked fine for me on Windows using CMake - an excellent job of cross platform configuration!

I've detailed the steps I took below in case anyone else needs to do the same. Is there a wiki page these could be added to?

1. Setup the Python virtual environment

pip install virtualenv
virtualenv.exe C:\VirtualEnvs\osgeolive
C:\VirtualEnvs\osgeolive\Scripts\activate
pip install sphinx==1.6.5
pip install sphinx-intl
pip install sphinxjp.themes.revealjs

2. Download and unzip Strawberry Perl (a portable version of Perl that runs on Windows) from http://strawberryperl.com/releases.html e.g. http://strawberryperl.com/download/5.26.2.1/strawberry-perl-5.26.2.1-64bit-portable.zip

3. Install the required Perl package:

SET PERL_HOME=D:\Tools\strawberry-perl-5.26.2.1-64bit-portable
SET PATH=%PERL_HOME%\perl\site\bin;%PERL_HOME%\perl\bin;%PERL_HOME%\c\bin;%PATH%
perl -MCPAN -e shell
install Text::SimpleTable::AutoWidth
exit

4. Download and unzip CMake (https://cmake.org/download/ - a portable version can be used e.g. https://cmake.org/files/v3.11/cmake-3.11.1-win64-x64.zip)

5. Create the build folder and checkout the latest code:

cd /D D:\OSGeoLive-doc
git clone https://github.com/OSGeo/OSGeoLive-doc.git
mkdir build
cd build

6. Create the Visual Studio projects using Cmake:

D:\Tools\cmake-3.9.1-win64-x64\bin\cmake -DHTML=ON ..

7. Set the Visual Studio environment variables (in this example VS2017) and build the projects using msbuild

"C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
msbuild ALL_BUILD.vcxproj 

The output is also in build/doc/_build/html/

To rebuild the docs again in a new command prompt run the commands below:

C:\VirtualEnvs\osgeolive\Scripts\activate
SET PERL_HOME=D:\Tools\strawberry-perl-5.26.2.1-64bit-portable
SET PATH=%PERL_HOME%\perl\site\bin;%PERL_HOME%\perl\bin;%PERL_HOME%\c\bin;%PATH%
"C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
cd /D D:\OSGeoLive-doc\build
D:\Tools\cmake-3.9.1-win64-x64\bin\cmake -DHTML=ON ..
msbuild ALL_BUILD.vcxproj


--
web:http://geographika.co.uk
twitter: @geographika