diff --git a/vasl_templates/webapp/static/help/images/add-ssr.png b/vasl_templates/webapp/static/help/images/add-ssr.png index fe1580d..5e95d25 100644 Binary files a/vasl_templates/webapp/static/help/images/add-ssr.png and b/vasl_templates/webapp/static/help/images/add-ssr.png differ diff --git a/vasl_templates/webapp/static/help/images/add-ssr.small.png b/vasl_templates/webapp/static/help/images/add-ssr.small.png index b51213d..8a34140 100644 Binary files a/vasl_templates/webapp/static/help/images/add-ssr.small.png and b/vasl_templates/webapp/static/help/images/add-ssr.small.png differ diff --git a/vasl_templates/webapp/static/help/images/draggable-overlays.png b/vasl_templates/webapp/static/help/images/draggable-overlays.png index 6170982..81d1afb 100644 Binary files a/vasl_templates/webapp/static/help/images/draggable-overlays.png and b/vasl_templates/webapp/static/help/images/draggable-overlays.png differ diff --git a/vasl_templates/webapp/static/help/images/draggable-overlays.small.png b/vasl_templates/webapp/static/help/images/draggable-overlays.small.png index 8305277..fde58b5 100644 Binary files a/vasl_templates/webapp/static/help/images/draggable-overlays.small.png and b/vasl_templates/webapp/static/help/images/draggable-overlays.small.png differ diff --git a/vasl_templates/webapp/static/help/images/edit-template.png b/vasl_templates/webapp/static/help/images/edit-template.png index 3a984e4..a976cef 100644 Binary files a/vasl_templates/webapp/static/help/images/edit-template.png and b/vasl_templates/webapp/static/help/images/edit-template.png differ diff --git a/vasl_templates/webapp/static/help/images/edit-template.small.png b/vasl_templates/webapp/static/help/images/edit-template.small.png index c02fb80..d300a77 100644 Binary files a/vasl_templates/webapp/static/help/images/edit-template.small.png and b/vasl_templates/webapp/static/help/images/edit-template.small.png differ diff --git a/vasl_templates/webapp/static/help/images/edit-vehicle.png b/vasl_templates/webapp/static/help/images/edit-vehicle.png new file mode 100644 index 0000000..807bdef Binary files /dev/null and b/vasl_templates/webapp/static/help/images/edit-vehicle.png differ diff --git a/vasl_templates/webapp/static/help/images/edit-vehicle.small.png b/vasl_templates/webapp/static/help/images/edit-vehicle.small.png new file mode 100644 index 0000000..0990cb7 Binary files /dev/null and b/vasl_templates/webapp/static/help/images/edit-vehicle.small.png differ diff --git a/vasl_templates/webapp/static/help/images/extras-templates.png b/vasl_templates/webapp/static/help/images/extras-templates.png index 54c7329..4bb02b5 100644 Binary files a/vasl_templates/webapp/static/help/images/extras-templates.png and b/vasl_templates/webapp/static/help/images/extras-templates.png differ diff --git a/vasl_templates/webapp/static/help/images/extras-templates.small.png b/vasl_templates/webapp/static/help/images/extras-templates.small.png index 51422fd..e3d9325 100644 Binary files a/vasl_templates/webapp/static/help/images/extras-templates.small.png and b/vasl_templates/webapp/static/help/images/extras-templates.small.png differ diff --git a/vasl_templates/webapp/static/help/images/load-template-pack.png b/vasl_templates/webapp/static/help/images/load-template-pack.png index c1808dd..10100f6 100644 Binary files a/vasl_templates/webapp/static/help/images/load-template-pack.png and b/vasl_templates/webapp/static/help/images/load-template-pack.png differ diff --git a/vasl_templates/webapp/static/help/images/load-template-pack.small.png b/vasl_templates/webapp/static/help/images/load-template-pack.small.png index e1659ff..a72e7ab 100644 Binary files a/vasl_templates/webapp/static/help/images/load-template-pack.small.png and b/vasl_templates/webapp/static/help/images/load-template-pack.small.png differ diff --git a/vasl_templates/webapp/static/help/images/ob_setup.png b/vasl_templates/webapp/static/help/images/ob_setup.png index 7210c14..8f46925 100644 Binary files a/vasl_templates/webapp/static/help/images/ob_setup.png and b/vasl_templates/webapp/static/help/images/ob_setup.png differ diff --git a/vasl_templates/webapp/static/help/images/ob_setup.small.png b/vasl_templates/webapp/static/help/images/ob_setup.small.png index dad49c0..6331b2b 100644 Binary files a/vasl_templates/webapp/static/help/images/ob_setup.small.png and b/vasl_templates/webapp/static/help/images/ob_setup.small.png differ diff --git a/vasl_templates/webapp/static/help/images/ob_vehicles.png b/vasl_templates/webapp/static/help/images/ob_vehicles.png index 4d16ec3..441c437 100644 Binary files a/vasl_templates/webapp/static/help/images/ob_vehicles.png and b/vasl_templates/webapp/static/help/images/ob_vehicles.png differ diff --git a/vasl_templates/webapp/static/help/images/ob_vehicles.small.png b/vasl_templates/webapp/static/help/images/ob_vehicles.small.png index 44a8262..dc4925a 100644 Binary files a/vasl_templates/webapp/static/help/images/ob_vehicles.small.png and b/vasl_templates/webapp/static/help/images/ob_vehicles.small.png differ diff --git a/vasl_templates/webapp/static/help/images/pf.png b/vasl_templates/webapp/static/help/images/pf.png index 4d13a25..aaee329 100644 Binary files a/vasl_templates/webapp/static/help/images/pf.png and b/vasl_templates/webapp/static/help/images/pf.png differ diff --git a/vasl_templates/webapp/static/help/images/pf.small.png b/vasl_templates/webapp/static/help/images/pf.small.png index 1509de3..2074d9d 100644 Binary files a/vasl_templates/webapp/static/help/images/pf.small.png and b/vasl_templates/webapp/static/help/images/pf.small.png differ diff --git a/vasl_templates/webapp/static/help/images/scenario.png b/vasl_templates/webapp/static/help/images/scenario.png index 9aed418..753b19a 100644 Binary files a/vasl_templates/webapp/static/help/images/scenario.png and b/vasl_templates/webapp/static/help/images/scenario.png differ diff --git a/vasl_templates/webapp/static/help/images/scenario.small.png b/vasl_templates/webapp/static/help/images/scenario.small.png index dd716eb..ed0de53 100644 Binary files a/vasl_templates/webapp/static/help/images/scenario.small.png and b/vasl_templates/webapp/static/help/images/scenario.small.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr-template.png b/vasl_templates/webapp/static/help/images/ssr-template.png index 40398fc..13505fa 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr-template.png and b/vasl_templates/webapp/static/help/images/ssr-template.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr-template.small.png b/vasl_templates/webapp/static/help/images/ssr-template.small.png index 3c6d8a2..63766c2 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr-template.small.png and b/vasl_templates/webapp/static/help/images/ssr-template.small.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr-template2.png b/vasl_templates/webapp/static/help/images/ssr-template2.png index de9789c..9136a2f 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr-template2.png and b/vasl_templates/webapp/static/help/images/ssr-template2.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr-template2.small.png b/vasl_templates/webapp/static/help/images/ssr-template2.small.png index 3cc8353..c185512 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr-template2.small.png and b/vasl_templates/webapp/static/help/images/ssr-template2.small.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr.png b/vasl_templates/webapp/static/help/images/ssr.png index f073777..a5c59a6 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr.png and b/vasl_templates/webapp/static/help/images/ssr.png differ diff --git a/vasl_templates/webapp/static/help/images/ssr.small.png b/vasl_templates/webapp/static/help/images/ssr.small.png index 743474b..aaeb1e5 100644 Binary files a/vasl_templates/webapp/static/help/images/ssr.small.png and b/vasl_templates/webapp/static/help/images/ssr.small.png differ diff --git a/vasl_templates/webapp/static/help/images/vc.png b/vasl_templates/webapp/static/help/images/vc.png index 4560c44..85b8202 100644 Binary files a/vasl_templates/webapp/static/help/images/vc.png and b/vasl_templates/webapp/static/help/images/vc.png differ diff --git a/vasl_templates/webapp/static/help/images/vc.small.png b/vasl_templates/webapp/static/help/images/vc.small.png index abf2590..7e8ca1e 100644 Binary files a/vasl_templates/webapp/static/help/images/vc.small.png and b/vasl_templates/webapp/static/help/images/vc.small.png differ diff --git a/vasl_templates/webapp/static/help/index.html b/vasl_templates/webapp/static/help/index.html index 155f8c2..2df8e3e 100644 --- a/vasl_templates/webapp/static/help/index.html +++ b/vasl_templates/webapp/static/help/index.html @@ -80,14 +80,15 @@ and then connect to it in a browser at http://localhost:5010. docker run --rm -it --name vasl-templates \ -p 5010:5010 \ -v /home/pacman-ghost/vasl/vasl-6.4.4.vmod:/data/vasl.vmod \ + -v /home/pacman-ghost/vasl/extensions/:/data/vasl-extensions \ vasltemplates/images:latest -If you have Chapter H data, add the following: +To include Chapter H data, add the following:
-v /home/pacman-ghost/vasl/chapter-h:/data/chapter-h-notes

Then open a browser and connect to the webapp at http://localhost:5010. -

Note that some features (e.g. updating a VASL scenario file) may not be available. -

If you have SElinux enabled, it may prevent the container from accessing the VASL .vmod file, in which case, you can allow access like this: -
chcon -Rt svirt_sandbox_file_t /home/pacman-ghost/vasl/vasl-6.4.4.vmod
+

Note that some features (e.g. updating and analyzing VASL scenario files) may not be available. +

If you have SElinux enabled, it may prevent the container from accessing files on the host. Access can be allowed like this: +
chcon -Rt svirt_sandbox_file_t /home/pacman-ghost/vasl/

Installing a webdriver

@@ -126,7 +127,7 @@ The program will then not attempt to create the embedded browser, and will just

-VASL Templates makes it easy to set up attractive VASL scenarios, with loads of useful information embedded to assist with game play. +VASL Templates makes it easy to set up attractive VASL scenarios, with loads of useful information embedded to assist with game play.

We'll show how by walking through a setup of everyone's favorite scenario, Hill 621. Click on the screenshot to the right to see the finished scenario.

You can find more examples here, with files that you can load into the program, together with the generated VASL scenarios. @@ -149,6 +150,12 @@ To create a label in VASL, open the Draggable Overlays window, and drag Once you have a label in VASL, copy the HTML snippet generated above into it.

Repeat the process to add the ELR and SAN for both players, and you will now have two labels that you can position in the VASL scenario. +

Automatically adding labels to the VASL scenario

+

Once you've got the hang of adding labels to your VASL scenario, you can get VASL Templates to do it automatically for you. After entering all the scenario details, choose Update VASL scenario from the menu, select the .vsav file you want to update, and all the labels will be inserted into the scenario (or updated, if they're already there). +

VASSAL will be run to update the scenario, so you may see it temporarily appear on-screen. The process can be a little slow, and may take several minutes to complete.
+ +
+

Adding victory conditions and SSR's

@@ -172,14 +179,11 @@ Once they're all in, click on the Snippet button to get a nicely format

Adding each vehicle and ordnance for each player is just a matter of selecting them from a list, and the generated HTML snippet will produce a table of information for each one (see right). Very handy if you have a menagerie of armor and you're, say, looking for something that can fire Smoke.

The scenario date is taken into account when generating these tables e.g. APCR for the Pz IVH is A52, but since the program knows the scenario is set in 1944, it just shows A5. Had the scenario been set in 1941, it wouldn't be shown at all. -

Double-click on an entry to make changes to it e.g. because an SSR changes its capabilities, or you'd like to add a note.

It's also possible to include Chapter H notes in your scenarios, although you will need to set some things up first.
-

Analyzing a VASL scenario

- -

If you have already set up the VASL scenario, you can also choose "Analyze VASL scenario" from the menu, and the program will identify vehicles and ordnance, and automatically create entries for each one. Only counters from the two configured nationalities will be imported, so make sure you set these first. - +

+Double-click on an entry to make changes to it e.g. because an SSR changes its capabilities, or you'd like to add a note.

@@ -188,12 +192,16 @@ We can also add ad-hoc notes describing where and how units should setup.

-Finally, if special support weapons such as PF and BAZ are in play, snippets are available with information for them, and as with vehicles/ordnance, they are date-aware and update themselves accordingly. +Finally, if special support weapons such as PF and BAZ are in play, snippets are available with information for them. As with vehicles/ordnance, they are date-aware and update themselves accordingly. + +

Analyzing a VASL scenario

+ +

If you have already set up the VASL scenario, you can choose "Analyze VASL scenario" from the menu, and the program will scan the .vsav file for vehicles and ordnance, and automatically create entries for each one. Only counters from the two configured nationalities will be imported, so make sure you set these first.

Extra templates

-

Extra templates are also available to generate ad-hoc snippets e.g. to keep track of how many PF shots you have left, or to generate a shaded box that can be inserted behind the Turn Track to indicate an LV Hindrance. +

Extra templates are also available to generate other kinds of snippets e.g. to keep track of how many PF shots you have left, or to generate a shaded box that can be inserted behind the Turn Track to indicate an LV Hindrance.

Including your own images

@@ -221,7 +229,7 @@ or a width and/or height parameter to explicitly set the image

@@ -235,13 +243,11 @@ or a width and/or height parameter to explicitly set the image
  • If you are running the Windows desktop application, open the Server settings dialog from the File menu and configure it there.
  • If you are running the web server directly, create a file called site.cfg in the $/config/ directory and configure it there (there is an example file you can rename and edit). -
    You should configure version 6.4.0 thru 6.4.4, of the VASL module.

    Once you've configured the VASL module, if you want to also show VASL counter images in the OB snippets that you copy in the VASL scenario, turn this on in the User settings dialog from the main application menu. -

    If you turn this feature on, the program must be running every time you load the scenario into VASL.

    Show Chapter H vehicle/ordnance notes as images

    -

    If you have set up the Chapter H vehicle/ordnance notes as HTML, it may not be possible to get the layout you want, since VASSAL's HTML engine is so old. To work around this, this option tells VASL Templates to render the HTML itself (using a modern browser) and send it as an image to VASSAL, which is slower but gives better results. +

    If you have set up the Chapter H vehicle/ordnance notes as HTML, it may not be possible to get the layout you want, since VASSAL's HTML engine is very old and doesn't support many HTML/CSS features. To work around this, this option tells VASL Templates to render the HTML itself (using a modern browser) and send it as an image to VASSAL, which is slower but gives better results.

  • @@ -308,7 +314,16 @@ We'll take a look at the ssr.j2 file, which is used to generate snippet

    Open the file in a text editor (if you're on Windows, you will probably need to right-click on the file and choose Open with...), and you'll see something like this:

    -<html> +<html> <!-- vasl-templates:id {{SNIPPET_ID}} --> + +<head> +<meta charset="utf-8"> +<style> +{{CSS:common}} +ul#ssr { padding: 0 5px 0 13px ; } +ul#ssr li { margin-top: 2px ; } +</style> +</head> <table style=" {%if SSR_WIDTH%} width: {{SSR_WIDTH}} ; {%endif%} @@ -318,15 +333,15 @@ We'll take a look at the ssr.j2 file, which is used to generate snippet <td style=" background: #f0f0f0 ; border-bottom: 1px solid #c0c0c0 ; + padding: 2px 5px ; + font-size: 105% ; font-weight: bold ; "> - <b>Scenario Special Rules</b> + Scenario Special Rules <tr> <td> -<ul style="margin:0 0 0 10px;"> -{%for ssr in SSR%} - <li> {{ssr}} -{%endfor%} +<ul id="ssr"> +{%for ssr in SSR%} <li> {{ssr}} {%endfor%} </ul> </table> @@ -359,10 +374,8 @@ But if the user hasn't specified anything for this field, what's between the There will often be multiple SSR's, and near the bottom of the file, we can see how these are handled:
    -<ul style="margin:0 0 0 10px;"> -{%for ssr in SSR%} - <li> {{ssr}} -{%endfor%} +<ul id="ssr"> +{%for ssr in SSR%} <li> {{ssr}} {%endfor%} </ul>
    This sets up an HTML list (<ul>) and repeats everything between the {%for ...%} and {%endfor%}, once for each entry in the SSR variable, which contains the SSR's entered by the user in the UI. Each time around, {{ssr}} will be updated to hold the next entry, which will be inserted into the generated HTML snippet as a <li> node. @@ -446,13 +459,14 @@ docker build --tag vasl-templates . docker run --rm -it --name vasl-templates \ -p 5010:5010 \ -v /home/pacman-ghost/vasl/vasl-6.4.4.vmod:/data/vasl.vmod \ + -v /home/pacman-ghost/vasl/extensions/:/data/vasl-extensions \ vasl-templates
    -
    The "Update VASL scenario" feature is currently not working in a container.
    +
    The "Update VASL scenario" and "Analyze VASL scenario" features are currently not available in a container.
    -

    Note that if you have SElinux enabled, it may prevent the container from accessing the VASL .vmod file, in which case, you can allow access like this: +

    Note that if you have SElinux enabled, it may prevent the container from accessing files on the host, in which case access can be allowed like this:

    -chcon -Rt svirt_sandbox_file_t /home/pacman-ghost/vasl/vasl-6.4.4.vmod +chcon -Rt svirt_sandbox_file_t /home/pacman-ghost/vasl/

    Creating a pre-compiled package