Merge branch 'adodown' into dev

.github/workflows/build_adodown_site.yaml

@@ -0,0 +1,71 @@
+on:
+  push:
+    branches: [main, dev]
+
+name: Build Site
+
+jobs:
+  adodownr:
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+
+      - name: Checkout project
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v3
+
+      - name: Setup R
+        uses: r-lib/actions/setup-r@v2
+        with:
+          use-public-rspm: true
+
+      - name: Install Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        with:
+          version: 1.0.37
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get install -y make libcurl4-openssl-dev libssl-dev libfontconfig1-dev libfreetype6-dev libfribidi-dev libharfbuzz-dev libjpeg-dev libpng-dev libtiff-dev libicu-dev pandoc libxml2-dev libgit2-dev libssh2-1-dev zlib1g-dev git
+
+      - name: Install devtools
+        run: install.packages("devtools")
+        shell: Rscript {0}
+
+      - name: Install adodownr
+        run: devtools::install_github("lsms-worldbank/adodownr")
+        shell: Rscript {0}
+
+      - name: Install here
+        run: install.packages("here")
+        shell: Rscript {0}
+
+      - name: Build site
+        run: adodownr::build_site(pkg_dir = here::here(), site_dir = here::here())
+        shell: Rscript {0}
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: ./docs
+
+  deploy:
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{steps.deployment.outputs.page_url}}
+    runs-on: ubuntu-latest
+    needs: adodownr
+    steps:
+        - name: Deploy to GitHub Pages
+          id: deployment
+          uses: actions/deploy-pages@v2

.gitignore

@@ -1,7 +1,7 @@
 ########################################################################
 #
-# This .gitignore file is based on DIME's template
-# https://github.com/worldbank/DIMEwiki/tree/master/Topics/GitHub
+# Created using adodown https://lsms-worldbank.github.io/adodown/, based on DIME .gitignore template:
+# https://github.com/worldbank/dime-github-trainings/tree/main/GitHub-resources/DIME-GitHub-Templates
 #
 ########################################################################
 
@@ -17,14 +17,18 @@
 # These files include GitHub settings
 !.gitignore
 !.gitattributes
-#.io page
-_config.yml
-!reproot.yaml
+!.github/**/*.yaml
+
+# Git placeholder file (to commit empty folders)
+!/**/*.gitkeep
 
 # Keep markdown files used for documentation on GitHub
 !README.md
 !CONTRIBUTING.md
-!LICENSE
+!LICENSE*
+
+* Unignore reproot files
+!reproot*.yaml
 
 #######################
 # For performance reasons, if a folder is already ignored, then
@@ -36,44 +40,28 @@ _config.yml
 
 #######################
 # The following file types are code that should always be
-# included no matter where in the DataWork folder they are
-# located unless that folder is explicitly ignored. See example
-# with EncryptedData folder below.
+# included no matter where in the repository folder they are
+# located unless you explicitly ignore that folder
 
 # Stata
 !/**/*.do
 !/**/*.ado
-!/**/*.sthlp
-!/**/*.stpr
-
-# R
-!/**/*.R
-
-# Outputs
-!/**/*.tex
-!/**/*.csv
+!/**/sthlp/*.sthlp
+!src/stata.toc
+!src/*.pkg
 
-# Python
-!/**/*.py
-
-# Matlab
-!/**/*.m
-
-# Markdown
+# Markdown and web docs files
 !/**/*.md
+!src/dev/**/*.png
+!src/dev/**/*.css
 
-# The folder test/ is used for peoples individual testing,
-# this is different from the test scripts in the folder run/
-test/
+####################################
+# Ignore ssc outputs
+src/dev/ssc
 
-###########
-# Outputs in the run/outputs folder
-!/**/outputs/**/*.csv
-
-# ignore all iegitaddmd output, results tested with checksums
-/**/iegitaddmd/outputs/
+# Ignore test inputs and outputs
+src/tests/**/inputs/
+src/tests/**/outputs/
 
 * Ignore the local dev env set up by repado
-run/dev-env/
-
-run/ieboilstart/ado-test/
+src/tests/dev-env/