Set up parceljs (#389)

* Set up parceljs

* Fix static file

* Add map files

* Fix EmbeddedResource

* Naming

* Remove duplicate sphinx script

* Add `./build.sh watch` to integrate all continuous builds. (#390)

All continuous builds are now servicable through `dotnet watch`

> dotnet watch --project src/docs-builder --no-hot-reload -- serve

Will build web assets without recompiling c# or rebooting the server.

C# or cshtml changes will rebuild automatically.

Markdown files will continue to be server through liverload without a full restart.

Co-authored-by: Jan Calanog <[email protected]>

---------

Co-authored-by: Martijn Laarman <[email protected]>

Author: reakaleek

.github/actions/bootstrap/action.yml

@@ -30,4 +30,11 @@ runs:
         echo "Version Number: ${REPO_VERSION}"
         echo "REPO_VERSION=${REPO_VERSION}" >> $GITHUB_ENV
         echo "full-version=${REPO_VERSION}" >> $GITHUB_OUTPUT
-        echo "major-version=$(echo ${REPO_VERSION} | cut -d"." -f1)" >> $GITHUB_OUTPUT
+        echo "major-version=$(echo ${REPO_VERSION} | cut -d"." -f1)" >> $GITHUB_OUTPUT
+        
+    - uses: actions/setup-node@v4
+      with:
+        cache: npm
+        cache-dependency-path: src/Elastic.Markdown/package-lock.json
+        node-version-file: .nvmrc
+      

.nvmrc

@@ -0,0 +1 @@
+22.13.1

README.md

@@ -137,6 +137,29 @@ To test performance it's best to build the binary and run outside of docker:
 For reference here's the `markitpy-doc` docset (50k markdown files) currently takes `14s` vs `several minutes` compared to
 existing surveyed tools
 
+# Local Development
+
+## Preqrequisites
+
+- [.NET 9.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0)
+- [Node.js 22.13.1 (LTS)](https://nodejs.org/en/blog/release/v22.13.1)
+
+
+## Continuously build all assets during development.
+
+```shell
+./build.sh watch
+```
+
+This will monitor code, cshtml template files & static files and reload the application
+if any changes.
+
+Web assets are reloaded through `parcel watch` and don't require a recompilation.
+
+Markdown files are refreshed automatically through livereload
+
+Code or layout changes will relaunch the server automatically
+
 # Release Process
 
 This section outlines the process for releasing a new version of this project.

build/CommandLine.fs

@@ -17,7 +17,8 @@ type Build =
     | [<CliPrefix(CliPrefix.None);SubCommand>] Test
 
     | [<CliPrefix(CliPrefix.None);SubCommand>] Format
-    
+    | [<CliPrefix(CliPrefix.None);SubCommand>] Watch
+
     | [<CliPrefix(CliPrefix.None);Hidden;SubCommand>] Lint
     | [<CliPrefix(CliPrefix.None);Hidden;SubCommand>] PristineCheck
     | [<CliPrefix(CliPrefix.None);Hidden;SubCommand>] ValidateLicenses
@@ -46,7 +47,9 @@ with
             | Release -> "runs build, tests, and create and validates the packages shy of publishing them"
             | Publish -> "Publishes artifacts"
             | Format -> "runs dotnet format"
-            
+
+            | Watch -> "runs dotnet watch to continuous build code/templates and web assets on the fly"
+
             // steps
             | Lint
             | PristineCheck

build/Targets.fs

@@ -35,6 +35,8 @@ let private version _ =
 
 let private format _ = exec { run "dotnet" "format" "--verbosity" "quiet" }
 
+let private watch _ = exec { run "dotnet" "watch" "--project" "src/docs-builder" "--no-hot-reload" "--" "serve" }
+
 let private lint _ =
     match exec {
         exit_code_of "dotnet" "format" "--verify-no-changes"
@@ -167,6 +169,7 @@ let Setup (parsed:ParseResults<Build>) =
                 release
 
         | Format -> Build.Step format
+        | Watch -> Build.Step watch
 
         // steps
         | Lint -> Build.Step lint

src/Elastic.Markdown/.gitignore

@@ -0,0 +1,6 @@
+.parcel-cache/
+node_modules/
+_static/main.js
+_static/main.js.map
+_static/styles.css
+_static/styles.css.map