Quick Save

Author: R. S. Doiel

INSTALL.html

@@ -25,6 +25,12 @@
 or follow along at the website <a
 href="https://caltechlibrary.github.io/t2t3_dataset_web_apps"
 class="uri">https://caltechlibrary.github.io/t2t3_dataset_web_apps</a>.</p>
+<p>If you need to install software like dataset please look at <a
+href="INSTALL_NOTES_macOS.html">INSTALL_NOTES_macOS.md</a> or <a
+href="INSTALL_NOTES_Windows.html">INSTALL_NOTES_Windows.md</a> if you
+are running macOS or Windows. The software provided is not “signed” and
+you may get security warnings on your system when you install using the
+installer script provided on the website for the project.</p>
 </section>
 </body>
 </html>

INSTALL.md

@@ -1,2 +1,4 @@
 
 This is a workshop presentation. You can download all the content from <https://github.com/caltechlibrary/t2t3_dataset_web_apps/releases> or follow along at the website <https://caltechlibrary.github.io/t2t3_dataset_web_apps>.
+
+If you need to install software like dataset please look at [INSTALL_NOTES_macOS.md](INSTALL_NOTES_macOS.md) or [INSTALL_NOTES_Windows.md](INSTALL_NOTES_Windows.md) if you are running macOS or Windows. The software provided is not "signed" and you may get security warnings on your system when you install using the installer script provided on the website for the project.

INSTALL_NOTES_Windows.md

@@ -0,0 +1,100 @@
+---
+title: t2t3_dataset_web_apps
+abstract: "The repository contains a presentation introducing web application construction using
+Dataset and Web Components. It is intended for the T2T3 series at Caltech Library.
+
+It presents the construction process to build a simple recipe collection system."
+authors:
+  - family_name: Doiel
+    given_name: R. S.
+    id: https://orcid.org/0000-0003-0900-6903
+
+
+
+repository_code: https://github.com/caltechlibrary/t2t3_dataset_web_apps
+version: 0.0.11
+license_url: https://caltechlibrary.github.io/t2t3_dataset_web_apps/LICENSE
+
+programming_language:
+  - HTML
+  - CSS
+  - JavaScript
+  - YAML
+  - SQL
+
+keywords:
+  - web applicaitons
+  - dataset
+  - JSON API
+  - web components
+  - presentation
+
+date_released: 2025-07-18
+---
+
+About this software
+===================
+
+## t2t3_dataset_web_apps 0.0.11
+
+Workshop is split into two parts. 
+
+1. Build a web application with dataset
+2. Enhance the browser experience with web components.
+
+This allows easy retrieval with curl (macOS and Linux) or irm (Windows and PowerShell).
+
+Updated the example components to conform to our naming conventions used in CL-Web-Components.
+
+Minimum CL-Web-Component version is now 0.0.12.
+
+Minimum Dataset Version now 2.3.2.
+
+### Authors
+
+- R. S. Doiel, <https://orcid.org/0000-0003-0900-6903>
+
+
+
+
+
+
+The repository contains a presentation introducing web application construction using
+Dataset and Web Components. It is intended for the T2T3 series at Caltech Library.
+
+It presents the construction process to build a simple recipe collection system.
+
+- License: <https://caltechlibrary.github.io/t2t3_dataset_web_apps/LICENSE>
+- GitHub: <https://github.com/caltechlibrary/t2t3_dataset_web_apps>
+- Issues: <https://github.com/caltechlibrary/t2t3_dataset_web_apps/issues>
+
+### Programming languages
+
+- HTML
+- CSS
+- JavaScript
+- YAML
+- SQL
+
+
+
+
+### Software Requirements
+
+- Terminal Application
+- Web Browser
+- Text Editor
+- Dataset &gt;&#x3D; v2.3.2
+- curl (or irm using PowerShell)
+
+
+### Software Suggestions
+
+- curl
+- jq
+- yq
+- htmlq
+- CMTools &gt;&#x3D; 0.0.35
+- CL-web-components &gt;&#x3D; 0.0.12
+
+

INSTALL_NOTES_macOS.md

@@ -0,0 +1,38 @@
+
+Installing an unsigned executable on macOS can be a bit tricky due to macOS's security features designed to protect users from potentially harmful software. Here's a general guide on how to do it:
+
+1. **Download the Executable**: First, download the unsigned executable file you want to install.
+
+2. **Locate the File**: Use Finder to locate the downloaded file. It's often in the `Downloads` folder unless you specified a different location.
+
+3. **Attempt to Open the File**: Double-click the file to open it. macOS will likely show a warning that the file cannot be opened because it is from an unidentified developer.
+
+4. **Override Security Settings**:
+   - **Option 1: Open via Context Menu**
+     - Right-click (or Control-click) the file.
+     - Select `Open` from the context menu.
+     - You'll see another warning, but this time there will be an option to `Open` the file anyway. Click `Open`.
+
+   - **Option 2: Allow Apps from Anywhere (Temporarily)**
+     - Open `System Preferences` and go to `Security & Privacy`.
+     - Click the lock icon in the bottom left corner and enter your password to make changes.
+     - Under the `General` tab, you might see a message about the app being blocked. Click `Open Anyway`.
+     - If you don't see this option, you can temporarily change the setting to allow apps downloaded from `Anywhere`. However, this option is not available in the latest versions of macOS by default. You may need to use the Terminal to do this:
+       - Open Terminal and type: `sudo spctl --master-disable`
+       - Press Enter and provide your password.
+       - This will allow you to run apps from anywhere, but it's recommended to re-enable security by typing `sudo spctl --master-enable` after installing your app.
+
+5. **Use Terminal (Advanced Users)**: If the above methods don't work, you can use the Terminal to run the executable directly:
+   - Open Terminal.
+   - Navigate to the directory where the file is located using the `cd` command.
+   - Make the file executable by typing: `chmod +x filename`
+   - Run the file by typing: `./filename`
+
+6. **Check for Updates**: Sometimes, developers will sign their apps later. Check if there's a signed version available to avoid these steps in the future.
+
+### Important Considerations
+
+- **Security Risks**: Running unsigned executables can expose your system to malware and other security risks. Only proceed if you trust the source of the software.
+- **System Integrity Protection (SIP)**: Some steps might be restricted by SIP, which is designed to protect your system. Disabling SIP is not recommended unless absolutely necessary.
+
+If you're unsure about any of these steps or the safety of the file, it's best to consult with someone who has more experience with macOS or to contact the software developer for support.

README.md

@@ -24,6 +24,12 @@ This is a workshop presentation for the DLD development group at Caltech Library
 Uses: - datasetd
 - web browser with JavaScript enabled
 
+## Software installation
+
+- [dataset install](https://caltechlibrary.github.io/dataset/INSTALL.html)
+  - [macOS NOTES](https://caltechlibrary.github.io/dataset/INSTALL_NOTES_macOS.html)
+  - [Windows NOTES](https://caltechlibrary.github.io/dataset/INSTALL_NOTES_Windows.html)
+
 ## Related resources
 
 - [Getting Help, Improving the Workshop or Reporting bugs](https://github.com/caltechlibrary/t2t3_dataset_web_apps/issues)

index.html

@@ -43,6 +43,20 @@ <h2 id="software-suggestions">Software Suggestions</h2>
 <li>htmlq</li>
 </ul>
 <p>Uses: - datasetd - web browser with JavaScript enabled</p>
+<h2 id="software-installation">Software installation</h2>
+<ul>
+<li><a
+href="https://caltechlibrary.github.io/dataset/INSTALL.html">dataset
+install</a>
+<ul>
+<li><a
+href="https://caltechlibrary.github.io/dataset/INSTALL_NOTES_macOS.html">macOS
+NOTES</a></li>
+<li><a
+href="https://caltechlibrary.github.io/dataset/INSTALL_NOTES_Windows.html">Windows
+NOTES</a></li>
+</ul></li>
+</ul>
 <h2 id="related-resources">Related resources</h2>
 <ul>
 <li><a