Merge pull request #147 from PovertyAction/feat/shell-pages

Add shell workshop pages

Author: NKeleher

.gitignore

@@ -228,3 +228,4 @@ rsconnect/
 **/*.quarto_ipynb
 
 /.luarc.json
+.claude/settings.local.json

.markdownlint.yaml

@@ -53,6 +53,8 @@ MD040: # Fenced code blocks should have a language specified
     - dot
     - graphviz
     - stata
+    - powershell
+    - output
 MD046: # Code block style
   style: fenced # Use fenced code blocks (```) rather than indented
 MD047: false # new line at the end of file

.pre-commit-config.yaml

@@ -20,20 +20,20 @@ repos:
         additional_dependencies:
           - tomli
   - repo: https://github.com/google/yamlfmt
-    rev: v0.20.0
+    rev: v0.21.0
     hooks:
       - id: yamlfmt
   - repo: https://github.com/abravalheri/validate-pyproject
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
   - repo: https://github.com/DavidAnson/markdownlint-cli2
-    rev: v0.18.1
+    rev: v0.20.0
     hooks:
       - id: markdownlint-cli2
         exclude: (.github/pull_request_template.md|LICENSE.md)
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.4
+    rev: v0.14.13
     hooks:
       - id: ruff-format
         types_or: [python, pyi, jupyter]
@@ -42,6 +42,6 @@ repos:
         types_or: [python, pyi, jupyter]
         require_serial: true
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.8
+    rev: v1.7.10
     hooks:
       - id: actionlint

README.md

@@ -47,10 +47,10 @@ should also have Git installed
 To get started, make sure you have `Just` installed on your computer by running the
 following from the command line:
 
-| Platform  | Commands                                                                                  |
-| --------- | ----------------------------------------------------------------------------------------- |
+| Platform  | Commands                    |
+| --------- | --------------------------- |
 | Windows   | `winget install Casey.Just` |
-| Mac/Linux | `brew install just`                                                |
+| Mac/Linux | `brew install just`         |
 
 This will make sure that you have the latest version of `Just`.
 

_freeze/software/python/coding-python/execute-results/html.json

@@ -72,6 +72,8 @@ website:
             href: ./data-collection/index.qmd
           - text: "Data Cleaning"
             href: ./data-cleaning/index.qmd
+          - text: "Data Science"
+            href: ./data-science/index.qmd
           - text: "Research Transparency"
             href: ./research-transparency/understanding-transparency.qmd
       - text: "How-to Guides"
@@ -88,6 +90,8 @@ website:
             href: ./research-transparency/how-to-publish-dataverse.qmd
       - text: "Software Guides"
         menu:
+          - text: "The Shell"
+            href: ./software/shell/index.qmd
           - text: "Git"
             href: ./software/git/index.qmd
           - text: "GitHub"
@@ -245,6 +249,76 @@ website:
             href: ./data-cleaning/dataset-documentation.qmd
           - text: "Data Aggregation"
             href: ./data-cleaning/data-aggregation.qmd
+      - section: "Data Science"
+        contents:
+          - text: "About Data Science"
+            href: ./data-science/index.qmd
+          - section: "Web Scraping"
+            contents:
+              - text: "Introduction to Web Scraping"
+                href: ./data-science/webscraping/index.qmd
+              - text: "Getting Started with Gazpacho"
+                href: ./data-science/webscraping/gazpacho-basics.qmd
+              - text: "Making HTTP Requests"
+                href: ./data-science/webscraping/getting-data.qmd
+              - text: "Parsing HTML with Soup"
+                href: ./data-science/webscraping/parsing-soup.qmd
+              - text: "Integration with Pandas"
+                href: ./data-science/webscraping/pandas-integration.qmd
+              - text: "Advanced Selection"
+                href: ./data-science/webscraping/strict-attributes.qmd
+          - section: "Python Data Analysis"
+            contents:
+              - text: "Introduction to Python"
+                href: ./data-science/data-analysis/index.qmd
+              - text: "Running and Quitting"
+                href: ./data-science/data-analysis/run-quit.qmd
+              - text: "Variables and Assignment"
+                href: ./data-science/data-analysis/variables.qmd
+              - text: "Data Types and Conversion"
+                href: ./data-science/data-analysis/types-conversion.qmd
+              - text: "Built-in Functions"
+                href: ./data-science/data-analysis/built-in.qmd
+              - text: "Libraries"
+                href: ./data-science/data-analysis/libraries.qmd
+              - text: "Lists"
+                href: ./data-science/data-analysis/lists.qmd
+              - text: "For Loops"
+                href: ./data-science/data-analysis/for-loops.qmd
+              - text: "Conditionals"
+                href: ./data-science/data-analysis/conditionals.qmd
+              - text: "Looping Over Data Sets"
+                href: ./data-science/data-analysis/looping-data-sets.qmd
+              - text: "Writing Functions"
+                href: ./data-science/data-analysis/writing-functions.qmd
+              - text: "Variable Scope"
+                href: ./data-science/data-analysis/scope.qmd
+              - text: "Programming Style"
+                href: ./data-science/data-analysis/style.qmd
+              - text: "Reading Tabular Data"
+                href: ./data-science/data-analysis/reading-tabular.qmd
+              - text: "Pandas DataFrames"
+                href: ./data-science/data-analysis/data-frames.qmd
+              - text: "Plotting"
+                href: ./data-science/data-analysis/plotting.qmd
+          - section: "Data Visualization"
+            contents:
+              - text: "Introduction to Visualization"
+                href: ./data-science/data-visualization/index.qmd
+              - text: "Introduction to Seaborn"
+                href: ./data-science/data-visualization/intro-seaborn-objects.qmd
+              - text: "Grammar of Graphics"
+                href: ./data-science/data-visualization/grammar-of-graphics.qmd
+              - text: "Marks and Geometric Objects"
+                href: ./data-science/data-visualization/marks-geometric-objects.qmd
+              - text: "Faceting and Layering"
+                href: ./data-science/data-visualization/faceting-layering.qmd
+              - text: "Labels and Customization"
+                href: ./data-science/data-visualization/labels-scales-customization.qmd
+              - text: "Statistical Transformations"
+                href: ./data-science/data-visualization/statistical-transformations.qmd
+              - text: "Themes and Final Polish"
+                href: ./data-science/data-visualization/themes-final-polish.qmd
       - section: "Research Transparency"
         contents:
           - text: "Understanding Research Transparency"
@@ -255,22 +329,58 @@ website:
             href: ./research-transparency/how-to-publish-dataverse.qmd
       - section: "Software Guides"
         contents:
-          - section: "Coding Guides"
+          - text: "Software Overview"
+            href: ./software/index.qmd
+          - section: "The Shell"
+            contents:
+              - text: "Introducing the Shell"
+                href: ./software/shell/index.qmd
+              - text: "File Management"
+                href: ./software/shell/filedir.qmd
+              - text: "Working With Files"
+                href: ./software/shell/create.qmd
+              - text: "Pipes and Filters"
+                href: ./software/shell/pipefilter.qmd
+              - text: "Loops"
+                href: ./software/shell/loops.qmd
+              - text: "Scripts"
+                href: ./software/shell/scripts.qmd
+              - text: "Finding Things"
+                href: ./software/shell/find.qmd
+          - section: "Virtual Environments"
             contents:
-              - text: "Virtual Environments"
-                href: ./software/guides/venv.qmd
+              - text: "Virtual Environments Overview"
+                href: ./software/virtualenv/index.qmd
+              - text: "Python Virtual Environments"
+                href: ./software/virtualenv/python-uv.qmd
+              - text: "Docker"
+                href: ./software/virtualenv/docker.qmd
           - section: "Version Control"
             contents:
               - text: "Git"
                 href: ./software/git/index.qmd
+              - text: "Getting Started with Git"
+                href: ./software/git/getting-started.qmd
+              - text: "Creating a Repository"
+                href: ./software/git/create-repo.qmd
+              - text: "Git Configuration"
+                href: ./software/git/configuration.qmd
+              - text: "Tracking Changes"
+                href: ./software/git/track-changes.qmd
+              - text: "Push and Pull Changes"
+                href: ./software/git/push-changes.qmd
+              - text: "Working with Branches"
+                href: ./software/git/branches.qmd
+              - text: "Creating Pull Requests"
+                href: ./software/git/pull-request.qmd
+              - text: "Handling Merge Conflicts"
+                href: ./software/git/conflicts.qmd
               - text: "GitHub"
                 href: ./software/github/index.qmd
           - section: "Code Environments"
             contents:
               - text: "VS Code"
                 href: ./software/vscode/index.qmd
-              - text: "Positron 🚧"
-                href: ./under-construction.qmd
           - section: "Stata"
             contents:
               - text: "Getting Started with Stata"
@@ -279,12 +389,6 @@ website:
                 href: ./software/stata/coding-stata.qmd
               - text: "Data Processing in Stata"
                 href: ./software/stata/data-processing-stata.qmd
-              - text: "Regular Expressions 🚧"
-                href: ./under-construction.qmd
-              - text: "Data Frames  🚧"
-                href: ./under-construction.qmd
-              - text: "Mapping in Stata 🚧"
-                href: ./under-construction.qmd
           - section: "Python"
             contents:
               - text: "Getting Started with Python"