This program lets you search through the ASL Rulebook index, and jump directly to the rules you're looking for.
Click [here](https://htmlpreview.github.io/?https://github.com/pacman-ghost/asl-rulebook2/blob/master/doc/features/index.html) for more details.
Click [here](https://code.pacman-ghost.com/preview/asl-rulebook2/doc/features/index.html) for more details.
<brclear="all">
With [some work](doc/extend.md), you can also:
@ -14,13 +14,13 @@ With [some work](doc/extend.md), you can also:
*NOTE: The program requires Firefox; Chrome doesn't support a key feature it needs.*
*NOTE: This project integrates with my other [`asl-articles`](https://github.com/pacman-ghost/asl-articles) project, so that if an article references a rule, it becomes a clickable link that will open a browser showing that rule. The [`vasl-templates`](https://github.com/pacman-ghost/vasl-templates) project can also be configured to allow vehicles and ordnance to open their corresponding Chapter H entries.*
*NOTE: This project integrates with my other [`asl-articles`](https://code.pacman-ghost.com/public/asl-articles) project, so that if an article references a rule, it becomes a clickable link that will open a browser showing that rule. The [`vasl-templates`](https://code.pacman-ghost.com/public/vasl-templates) project can also be configured to allow vehicles and ordnance to open their corresponding Chapter H entries.*
### Installation
After cloning the repo, you can either:
- run it using Docker (recommended, run `./run-container.sh --port 5020`)
- run it from source (requires Python 3.8.7, install the module, run `asl_rulebook2/webapp/run_server.py`)
- run it from source (install the module, run `asl_rulebook2/webapp/run_server.py`)
*NOTE: Run either command with `--help` to get help.*
["firstappearedintheASLAnnual'89.(In1998,bothwerereprintedin Classic ASL.)","first appeared in the ASL Annual '89. (In 1998, both were reprinted in Classic ASL.)"],
["One of the several criticisms","<p> One of the several criticisms"]
],
"12":[["TEMto","TEM to"]],
"14":[
["bipodmounted","bipod-mounted"],
["volume o f fire","volume of fire"]
],
"17":[["adistinct","a distinct"]],
"19":[["wellsited","well-sited"]],
"32":[["HWunits","HW units"]],
"33":[["multiLocation","multi-Location"]],
"10A":[["One of the several criticisms","<p> One of the several criticisms"]],
"14":[["bipodmounted","bipod-mounted"]],
"19":[["wellsited","well-sited"]],
"split:31A":{
"split_text":"31B. 25.212 RUSSIAN EARLY WAR DOCTRINE:",
"new_footnote_id":"31B",
"new_captions":[["A25.212","RUSSIAN EARLY WAR DOCTRINE"]]
},
"35":[["The original printing","<p> The original printing"]],
"37":[
["- Winter War (vs Soviet Union) 30 November 1939 - 13 March 1940- Continuation War (vs Soviet Union) 25 June 1941 - 4 September 1944- Lapland War (vs Germany) 15 September 1944 - 27 April 1945"," <ul> <li> <b>Winter War</b> (vs Soviet Union) 30 November 1939 - 13 March 1940 <li> <b>Continuation War</b> (vs Soviet Union) 25 June 1941 - 4 September 1944 <li> <b>Lapland War</b> (vs Germany) 15 Se ptember 1944 - 27 April 1945 </ul>"]
["Croatian units in Yugoslavia:"," <p> <b>Croatian units in Yugoslavia</b>:"],
["CroatianArmyunitswereengagedprimarilyinanti-partisanactivities,fightingmostly","Croatian Army units were engaged primarily in anti-partisan activities, fighting mostly"],
["WhiletheriflecompanydidnothaveaninherentHeavyWeapons(HW)platoon,it","While the rifle company did not have an inherent Heavy Weapons (HW) platoon, it"]
["Inthewinternight,thenear-freezingtemperaturecauseddewtoform.","In the winter night, the near-freezing temperature caused dew to form. "],
["Thenextmorningathickmistoftenformedasthesun evaporateditagain.","The next morning a thick mist often formed as the sun evaporated it again. "],
["Thiscouldhappeneveninthesummertimeundertheproperenvironmentalconditions,","This could happen even in the summertime under the proper environmental conditions, "],
["butsincethiswasamuchlessfrequentoccurrenceithasbeen ignored.","but since this was a much less frequent occurrence it has been ignored."]
],
"21":[
["Playerswillprobablyfinditmoreconvenienttoinstead","Players will probably find it more convenient to instead"],
["addathird,different-coloreddietothisTH/IFTDR,","add a third, different-colored die to this TH/IFT DR, "],
["usingittodeterminetheDust DRM.","using it to determine the Dust DRM."],
["Thefamiliarterm\"subsequentdr\"wasusedintherulebecauseitobviates theneed","The familiar term \"subsequent dr\" was used in the rule because it obviates the need"],
["a\"new\"concept","a \"new\" concept"],
["thatof rolling athird diesimultaneously","that of rolling a third die simultaneously"]
],
"22":[
["theDustcounter\"follows\"thevehicleasit movesfromhex to hex","the Dust counter \"follows\" the vehicle as it moves from hex to hex"],
["itexpends","it expends "],
["two MPeach timeitdoesso"," two MP each time it does so"]
],
"23":[
["Anotherwind-relatedaspectoftheNorthAfricanenvironmentisthedesertsandstorm,","Another wind-related aspect of the North African environment is the desert sandstorm, "],
["orkhamsininArabic.","or khamsin in Arabic. "],
["ChapterFincludesnospecial rulesforitbecause,","Chapter F includes no special rules for it because, "],
["withvisibilitycutbythestormtoaslittleasthreeyards,","with visibility cut by the storm to as little as three yards, "],
["allactivitiesgenerallywerereducedtoseekingcoverfromthesandblastingwindandchoking dust.","all activities generally were reduced to seeking cover from the sandblasting wind and choking dust. "],
["However,thegamedoesnotignorethepossibilityofakhamsin'soccurrence.","However, the game does not ignore the possibility of a khamsin's occurrence. "],
["The propercombinationofWeather,EC,WindandGustsinaDYOscenariocancreateits effects,","The proper combination of Weather, EC, Wind and Gusts in a DYO scenario can create its effects, "],
["andtheprobabilityofitsoccurrenceisgreatestinascenariosetinspringor summer","and the probability of its occurrence is greatest in a scenario set in spring or summer"],
["thetimewhen khamsinsoccurred mostfrequently.","the time when khamsins occurred most frequently."]
],
"24":[
["Thisoverlay isused in aHOLLOW LEGIONS scenario.","This overlay is used in a HOLLOW LEGIONS scenario."]
],
"25":[
["ThefamousNorthAfricanescarpmentsaresimilarto cliffs,","The famous North African escarpments are similar to cliffs, "],
["butwithlesssteep(andveryeroded)slopes.","but with less steep (and very eroded) slopes. "],
["Somearesixhundredfeethigh","Some are six hundred feet high"],
["thoughgenerallytheirheightsrangefromonehundredtotwohundredfeet.","though generally their heights range from one hundred to two hundred feet. "],
["Theirsignificanceinthedesertwarlaymainlyinthattheywerecommandingheights,","Their significance in the desert war lay mainly in that they were commanding heights, "],
["defensivepositionsforinfantry,","defensive positions for infantry, "],
["andgreatlyrestrictedvehicularmovementacrossthem","and greatly restricted vehicular movement across them"],
["Hencetheywereoftenthesceneofheavyfighting,","Hence they were often the scene of heavy fighting, "],
["especiallywherecrossedbya road","especially where crossed by a road"]
"new_content":"(Any fire attack requiring a LOS from the firer which does not use Indirect Fire): C.1, C9.1 [Intervening Units: A6.6] [LC: G12.61-.62, G12.671]"
<divclass="info">You<u>must</u> use the <a href="https://www.wargamevault.com/product/344879/Electronic-Advanced-Squad-Leader-Rulebook" target="_blank">officalMMPeASLRB</a>.<br>
<p> Once you've got the program up and running, you can then think about extending it. It's a lot of work, but the results are insanely cool!
<p> To the right, I've searched for <em>"cellar"</em>, and the program has found results from <em>Red Barricades</em>. The rules for this are referenced in the ASLRB index, but the content is not yet in the MMP eASLRB.
<p> However, I've installed a PDF scan of the rules, plus information about where each rule is within that PDF (a <em>"targets file"</em>), and so when I click on a search result, it seamlessly opens the <em>Red Barricades</em> PDF and jumps to that rule.
You can also include third-party modules that are not referenced in the ASLRB index. I've also installed a PDF of LFT's <em>Kampfgruppe Scherer</em>, a targets files for it, and also an <em>index file</em>. This last file is also searched, and clicking on a search result takes me directly to the associated rule in the KGS PDF.
You can also include third-party modules that are not referenced in the ASLRB index. I've also installed a PDF of LFT's <em>Kampfgruppe Scherer</em>, a targets file for it, and also an <em>index file</em>. This last file is also searched, and clicking on a search result takes me directly to the associated rule in the KGS PDF.
<br>
<p> I've also added information about chapters in the PDF, so that I can browse through them in the usual way: <br>
Q+A and errata can also be included. This is a <em>lot</em> of work, but the results are amazing. If you click on a rule that has Q+A and/or errata associated with it, they will be shown, alongside the rule you're looking for.
<p> Q+A and errata can also be included. This is a <em>lot</em> of work, but the results are amazing. If you click on a rule that has Q+A and/or errata associated with it, they will be shown, alongside the rule you're looking for.
<p> Here, I've searched for <em>"encircled"</em>, and the program has automatically shown Q+A and errata for rule <spanclass="ruleid">A7.7</span>.
<divclass="info"> Note that this errata is actually obsolete, since it's already been incorporated into the current MMP eASLRB, but it's shown here as an example. </div>
<brclear="all">
@ -54,19 +58,21 @@ Going back to the search results, you can see these Q+A entries included in ther
Pacman Ghost