Merge branch 'develop': release v1.0v1.0

8 files changed, 135 insertions, 0 deletions

diff --git a/scripts/.gitignore b/scripts/.gitignore
new file mode 100644
index 0000000..2cb7368
--- /dev/null
+++ b/scripts/.gitignore
@@ -0,0 +1 @@
+local_*
diff --git a/scripts/dev_win_build.cmd b/scripts/dev_win_build.cmd
new file mode 100644
index 0000000..ed96211
--- /dev/null
+++ b/scripts/dev_win_build.cmd
@@ -0,0 +1,5 @@
+@echo off
+cd ..\compiler\
+stack setup
+stack build
+pause
\ No newline at end of file
diff --git a/scripts/dev_win_compile_example.cmd b/scripts/dev_win_compile_example.cmd
new file mode 100644
index 0000000..35134c0
--- /dev/null
+++ b/scripts/dev_win_compile_example.cmd
@@ -0,0 +1,10 @@
+@echo off
+SET rebuild=--rebuild
+CHOICE /M "Rebuild all ('--rebuild' argument)?"
+IF ERRORLEVEL 2 SET rebuild=
+echo.
+cd ..\compiler\
+
+@echo on
+stack exec ldgallery -- %rebuild% --clean-output -i=../example/src/ -o=../example/out/
+@pause
diff --git a/scripts/dev_win_help.cmd b/scripts/dev_win_help.cmd
new file mode 100644
index 0000000..f0bdb98
--- /dev/null
+++ b/scripts/dev_win_help.cmd
@@ -0,0 +1,5 @@
+@echo off
+cd ..\compiler\
+stack exec ldgallery -- --help
+@echo.
+@pause
diff --git a/scripts/dev_win_start_vueui.cmd b/scripts/dev_win_start_vueui.cmd
new file mode 100644
index 0000000..e1a124d
--- /dev/null
+++ b/scripts/dev_win_start_vueui.cmd
@@ -0,0 +1,44 @@
+@echo off
+set NODE_VERSION=12.16.1
+set VUECLI_VERSION=4.2.3
+cd ..\viewer\
+
+chcp 65001
+echo.
+echo === nvm install ===
+nvm install %NODE_VERSION%
+nvm list | find /i "%NODE_VERSION% (Currently"
+if errorlevel 1 (
+  echo.
+  echo === nvm use %NODE_VERSION% ===
+  nvm use %NODE_VERSION%
+
+  echo.
+  echo === npm install @vue/cli@%VUECLI_VERSION% ===
+  ping localhost -n 3 >NUL
+  cmd /c npm install -g @vue/cli@%VUECLI_VERSION%
+)
+echo.
+vue --version | find /i "%VUECLI_VERSION%"
+if errorlevel 1 (
+  echo ======================================================================
+  echo Warning: vue/cli doesn't match the requested version: %VUECLI_VERSION%
+  echo.
+  echo CTRL+C to quit and update, or press a key to ignore this warning...
+  echo ======================================================================
+  echo.
+  pause
+)
+echo.
+echo === npm install ===
+cmd /c npm install
+echo.
+echo === npm prune ===
+cmd /c npm prune
+echo.
+echo === npm dedupe ===
+cmd /c npm dedupe
+echo.
+echo === vue ui ===
+title Vue UI - server
+vue ui
diff --git a/scripts/migrate_tags_dot_to_colon.py b/scripts/migrate_tags_dot_to_colon.py
new file mode 100755
index 0000000..bf56c4c
--- /dev/null
+++ b/scripts/migrate_tags_dot_to_colon.py
@@ -0,0 +1,25 @@
+#!/usr/bin/env nix-shell
+#!nix-shell -i python -p "python3.withPackages (ps: with ps; [ruamel_yaml])"
+
+from argparse import ArgumentParser
+from ruamel.yaml import YAML
+from collections.abc import Iterable
+
+parser = ArgumentParser(description='Converts tag separator from dot to colon in sidecar files, easing migration after GH-164.')
+parser.add_argument('file', type=str, nargs='+', help='YAML sidecar file(s) to migrate.')
+args = parser.parse_args()
+
+yaml = YAML(typ='rt')  # preserve order, style and comments
+yaml.indent(mapping=2, sequence=2, offset=2)
+
+for file_path in args.file:
+  with open(file_path, 'r+') as file:
+    sidecar = yaml.load(file)
+    if not sidecar: continue
+
+    if 'tags' in sidecar and isinstance(sidecar['tags'], Iterable):
+      sidecar['tags'] = [tag.replace('.', ':') for tag in sidecar['tags']]
+
+    file.seek(0)
+    yaml.dump(sidecar, file)
+    file.truncate()
diff --git a/scripts/readme.md b/scripts/readme.md
new file mode 100644
index 0000000..a20d858
--- /dev/null
+++ b/scripts/readme.md
@@ -0,0 +1,24 @@
+# ldgallery scripts
+
+Some utilities.
+Prefix the filename of your custom script with "local_", they are git-ignored.
+
+## Build
+
+### dev_win_build.cmd
+
+Build the compiler. See {../compiler/readme.md}
+
+### dev_win_help.cmd
+
+Shows the compiler's command line help.
+
+### dev_win_compile_example.cmd
+
+Compile the example gallery, for demonstration purposes. See {../example/readme.md}
+
+### win_generate_yaml_files.cmd
+
+Generates template YAML files for your gallery.
+Copy this CMD to your pictures folder.
+
diff --git a/scripts/win_generate_yaml_files.cmd b/scripts/win_generate_yaml_files.cmd
new file mode 100644
index 0000000..edb7f91
--- /dev/null
+++ b/scripts/win_generate_yaml_files.cmd
@@ -0,0 +1,21 @@
+@echo off
+
+REM Copy this file to your picture directory to quickly generate the YAML templates
+REM ===============================================================================
+
+for %%f in (*.jpg,*.png,*.gif) do (
+  if exist "%%f.yaml" goto CONTINUE
+    @echo %%f
+    (
+    echo title: %%f
+    echo.
+    echo datetime:
+    echo.
+    echo description:
+    echo.
+    echo tags:
+    echo   - not_tagged
+    ) >> "%%f.yaml"
+  :CONTINUE
+  rem
+)