Added a note about installation problems on Windows.

master
Pacman Ghost 6 years ago
parent f479ac3324
commit a76c5851fc
  1. 6
      vasl_templates/webapp/static/help/index.html
  2. 4
      vasl_templates/webapp/static/help/main.css

@ -50,7 +50,7 @@
<p> If you're on a Mac or Linux, you can run the program directly from the source code. Get a copy from <a href="https://github.com/pacman-ghost/vasl-templates">Github</a> in the usual way, by <tt>git clone</tt>'ing it, or downloading a ZIP and unpacking it somewhere.
<p> The web server was written and tested using Python 3.6, but it doesn't do anything particulaly funky, so any recent version of Python <em>should</em> work.
<p> The web server was written and tested using Python 3.6, but it doesn't do anything particularly funky, so any recent version of Python <em>should</em> work.
<p> While not essential, it is <em>strongly</em> recommended that you set up a <a href="https://virtualenv.pypa.io/en/stable/">virtual environment</a> first. Then, install the requirements:
<div class="code">
@ -59,7 +59,9 @@ pip install .
<h4> Running the desktop application </h4>
<p> To run the program as a desktop application, you will need to install Qt 5.10.0. While your distro may have it as a package, I didn't have much luck on Fedora 27, and had to install it manually using their <a href="https://www.qt.io/download">installer</a>.
<p> If you're on Windows, the Qt runtime will have been installed as part of PyQt5 (when you did the <tt>pip install</tt> above), but if you're in a virtual environment and you're getting <em>"DLL load failed"</em> errors, this is due to a problem with the way Python sets up the virtualenv. In the virtualenv's <tt>scripts/</tt> sub-directory, there should be <em>two</em> Python DLL's, so if you're missing <tt>python3.dll</tt>, copy it over from the Python installation the virtualenv was created from, and you should be good to go.
<p> If you're on Linux, you will need to install Qt 5.10.0. While your distro may have it as a package, I didn't have much luck on Fedora 27, and had to install it manually using their <a href="https://www.qt.io/download">installer</a>.
<p> Then, just run the <tt>vasl-templates</tt> command.
<h4> Running just the web server </h4>

@ -2,8 +2,8 @@
html { height: 100% ; }
body { height: 100% ; overflow: hidden ; }
h2 { margin-top: 1em ; clear: both ; }
h4 { margin-top: 0.5em ; clear: both ; }
h2 { margin-top: 1em ; clear: both ; color: #666 ; }
h4 { margin-top: 0.5em ; clear: both ; color: #666 ; }
p { margin-top: 0.5em ; }
.code { white-space: pre ; font-family: monospace ; margin: 0 1em 1em 2em ; }

Loading…
Cancel
Save