setup initial static site

Signed-off-by: Derek Worthen <[email protected]>

Author: dworthen

.editorconfig

@@ -0,0 +1,17 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 2
+
+# 4 space indentation
+[*.py]
+indent_style = space
+indent_size = 4

.gitignore

@@ -0,0 +1,5 @@
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+vendor

.post-template

@@ -0,0 +1,12 @@
+---
+title: Article Title
+slug: url-friendly-article-name
+layout: page
+description: short description
+summary: >-
+  Mulit-line Summary 
+  of the article
+image: assets/article-image.jpeg
+image-alt: image alt
+link: optional-external-link-used-by-cards
+---

404.md

@@ -0,0 +1,6 @@
+---
+layout: home
+title: 404
+description: Sorry, we couldn't find that page :(
+image: 'assets/lost.jpeg'
+---

Gemfile

@@ -0,0 +1,37 @@
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+gem "jekyll", "~> 4.2.2"
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minima", "~> 2.5"
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+# gem "github-pages", group: :jekyll_plugins
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+  gem "jekyll-feed", "~> 0.12"
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", "~> 1.2"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]
+
+gem "webrick", "~> 1.7"
+
+gem "jekyll-redirect-from", "~> 0.16.0"

Gemfile.lock

@@ -0,0 +1,86 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    colorator (1.1.0)
+    concurrent-ruby (1.1.10)
+    em-websocket (0.5.3)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0)
+    eventmachine (1.2.7)
+    ffi (1.15.5)
+    forwardable-extended (2.6.0)
+    http_parser.rb (0.8.0)
+    i18n (1.12.0)
+      concurrent-ruby (~> 1.0)
+    jekyll (4.2.2)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      em-websocket (~> 0.5)
+      i18n (~> 1.0)
+      jekyll-sass-converter (~> 2.0)
+      jekyll-watch (~> 2.0)
+      kramdown (~> 2.3)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 4.0)
+      mercenary (~> 0.4.0)
+      pathutil (~> 0.9)
+      rouge (~> 3.0)
+      safe_yaml (~> 1.0)
+      terminal-table (~> 2.0)
+    jekyll-feed (0.16.0)
+      jekyll (>= 3.7, < 5.0)
+    jekyll-redirect-from (0.16.0)
+      jekyll (>= 3.3, < 5.0)
+    jekyll-sass-converter (2.2.0)
+      sassc (> 2.0.1, < 3.0)
+    jekyll-seo-tag (2.8.0)
+      jekyll (>= 3.8, < 5.0)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    kramdown (2.4.0)
+      rexml
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    liquid (4.0.3)
+    listen (3.7.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    mercenary (0.4.0)
+    minima (2.5.1)
+      jekyll (>= 3.5, < 5.0)
+      jekyll-feed (~> 0.9)
+      jekyll-seo-tag (~> 2.1)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    public_suffix (4.0.7)
+    rb-fsevent (0.11.1)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rexml (3.2.5)
+    rouge (3.30.0)
+    safe_yaml (1.0.5)
+    sassc (2.4.0)
+      ffi (~> 1.9)
+    terminal-table (2.0.0)
+      unicode-display_width (~> 1.1, >= 1.1.1)
+    unicode-display_width (1.8.0)
+    webrick (1.7.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  http_parser.rb (~> 0.6.0)
+  jekyll (~> 4.2.2)
+  jekyll-feed (~> 0.12)
+  jekyll-redirect-from (~> 0.16.0)
+  minima (~> 2.5)
+  tzinfo (~> 1.2)
+  tzinfo-data
+  wdm (~> 0.1.1)
+  webrick (~> 1.7)
+
+BUNDLED WITH
+   2.3.19

README.md

@@ -1,3 +1,51 @@
-PyWhy’s mission is to build an open-source ecosystem for causal machine learning that moves forward the state-of-the-art and makes it available to practitioners and researchers. We build and host interoperable libraries, tools, and other resources spanning a variety of causal tasks and applications, connected through a common API on foundational causal operations and a focus on the end-to-end analysis process.
+# PyWhy static website (Jekyll)
 
-[Homepage on GitHub](https://github.com/py-why)
+This repo holds the source code and content to pywhy.org. 
+
+## Editing Content
+
+For significant changes, follow [GitHub Flow](https://guides.github.com/introduction/flow/): create a new branch and submit a pull request to get review feedback from other team members. Once the PR is merged to main, the site will automatically rebuild and deploy.
+
+The site is compiled using [Jekyll](https://jekyllrb.com/), so all of the content is written in [Markdown](https://daringfireball.net/projects/markdown/). In particular, Jekyll uses a superset of Markdown called Kramdown. [Syntax documentation here](https://kramdown.gettalong.org/syntax.html).
+
+### File struture
+
+The content is structured to avoid needing HTML editing for the site content. There are a few places content resides in order to be as obvious as possible while also adhering to Jekyll requirements.
+
+- Main pages (root): any *.md files in the root of the project directory are top-level pages (except this README!). Most pages are Markdown except for the main home page (index.html) because it requires advanced HTML layout that Markdown does not support. *.md files will be converted to HTML files automatically for the deployment.
+- Content chunks [/content](./content): Fragments of markdown content to be included in other markdown or html pages. Content markdown files do not contain YAML Front Matter as they are not standalone pages. 
+- Collections: represent types of content pages much like blog articles or news stories. Collections in this site include case studies articles (\_case_studies), learn content (\_learn), and news articles (\_news).
+
+### YAML Front Matter
+
+Every page has YAML front matter that gives Jekyll some instructions on how to process it:
+- title: displays a large-format title on the page.
+- layout: indicates what template should be used to render the page. Most pages will use the "page" template.
+- description: display a short description within cards. 
+- summary: a longer summary of the resource displayed in aggregate view (news page, case studies page, etc).
+- image: optional large-format image to include in the layout beackground behind the title.
+- image-alt: alt attribute for the image and must be present for the image to be shown.
+- slug: url friendly name for the page.
+- link: An optional link to an external resource. If present, the link attribute indicates that the page/resource
+  is external and generated cards and summaries will link out to the external resource instead of a local page.
+
+## Editing the Site Locally
+
+For deeper edits or site changes, you'll want to clone the repo and run Jekyll locally:
+
+- Install [Docker](https://www.docker.com/get-started) for your platform and make sure it is running
+- Install [Docker Compose](https://docs.docker.com/compose/install/) for your platform
+- From a terminal, `cd` into the cloned repo directory and run `docker-compose up`
+
+This will download the default Jekyll Docker container and spin up the Jekyll instance. Once it's ready (it might take a few minutes the first time), you can view the site at http://localhost:4000. The `docker-compose.yml` includes live reload config, so as you edit the site it will automatically refresh in your browser.
+
+### Removing pages
+
+If you need to remove a page, you'll want to redirect to preserve the links and prevent 404s for users that may have bookmarks.
+
+Use the Jekyll [redirect plugin](https://github.com/jekyll/jekyll-redirect-from). If you choose a new page that the user should be directed to, you can add front matter to the new page that configures redirects, then delete the old page. It looks something like this:
+
+```
+redirect_from:
+  - /data-collection.html
+```

_case_studies/01_causes_of_customer_churn_attrition.md

@@ -0,0 +1,7 @@
+---
+title: Causes of Customer Churn/Attrition
+description: Predict causal effect from the intervention.
+image: assets/causes-of-customer-churn-attrition.jpg
+image-alt: Causes of Customer Churn/Attrition
+link: https://medium.com/geekculture/a-quickstart-for-causal-analysis-decision-making-with-dowhy-2ce2d4d1efa9
+---

_case_studies/02_effect_of_home_visits_on_infant_health.md

@@ -0,0 +1,7 @@
+---
+title: Effects of Home Visits on Infant Health (IHDP)
+description: Understanding the question of why.
+image: assets/effects-of-home-visits-on-infant-health.jpg
+image-alt: Effects of Home Visits on Infant Health (IHDP)
+link: https://towardsdatascience.com/implementing-causal-inference-a-key-step-towards-agi-de2cde8ea599
+---

_case_studies/03_optimizing_article_headlines.md

@@ -0,0 +1,7 @@
+---
+title: Optimizing Article Headlines
+description: Introducing the do-sampler for causal inference.
+image: assets/optimizing-article-headlines.png
+image-alt: Optimizing Article Headlines
+link: https://medium.com/@akelleh/introducing-the-do-sampler-for-causal-inference-a3296ea9e78d
+---