Merge pull request #17 from nsidc/update-to-homepage

Update to homepage

Author: rmarow

CONTRIBUTING.md

@@ -1,20 +1,19 @@
 # Contributing
 
-## Authoring a post
+## Local development
 
-* Create a new directory for your post following existing directory structure
-  pattern
-    * Name the directory after your post
+First, create a local envirionment with `quarto` installed:
 
-* Name the markdown file containing your blog post `index.md`
-    * _Only_ name it `index.qmd` if the file is computational markdown, i.e.
-      contains executable code.
+```
+conda env create -f environment.yml
+conda activate nsidc-github-pages
+```
 
-* Populate markdown front-matter with metadata following pattern from existing
-  posts
-    * Include `title`, `description`, `author`, `date`, and `categories`
-      fields.
-    * Description should be a one-sentence introduction to the post.
+Next, startup the quarto development server:
 
-* Include any images or other assets that are specific to this post in the
-  post's directory
+```
+quarto preview
+```
+
+And finally, start developing content! Changes to content should get
+automatically updated in your browser.

README.md

@@ -1,11 +1,8 @@
-# NSIDC Technical Blog
+# NSIDC Github Pages
 
-This is a blog by and for NSIDC developers.
+This is landing page for NSIDC [GitHub Pages](https://pages.github.com/)-based
+websites.
 
-The website is built in GitHub Actions by [Quarto](https://quarto.org/), a modern technical
-publishing tool. The website is deployed to GitHub Pages.
-
-
-## Authoring a post
-
-Please see our [contributing](CONTRIBUTING.md) document.
+The website is built in GitHub Actions by [Quarto](https://quarto.org/), a
+modern technical publishing tool. The website is deployed to [GitHub
+Pages](https://pages.github.com/).

_quarto.yml

@@ -2,13 +2,9 @@ project:
   type: "website"
 
 website:
-  title: "NSIDC Technical Blog"
+  title: "NSIDC"
   navbar:
     right:
-      - text: "Home"
-        file: "index.md"
-      - text: "About"
-        file: "about.md"
       - icon: "github"
         href: "https://github.com/nsidc"
       - icon: "twitter"

about.md

@@ -1,4 +1,4 @@
-name: "nsidc-technical-blog"
+name: "nsidc-github-pages"
 channels:
   - "conda-forge"
   - "nodefaults"

environment.yml

@@ -1,14 +1,10 @@
 ---
-listing:
-  contents: "posts"
-  type: "default"
-  categories: true
-  sort:
-    - "date desc"
-    - "title"
-  sort-ui: true
-  filter-ui: true
-max-description-length: 250
-page-layout: "full"
-title-block-banner: true
+title: "NSIDC GitHub Pages"
 ---
+
+Welcome to the NSIDC [GitHub Pages](https://pages.github.com/) home page. This site serves as a landing-page for all of NSIDC's GitHub Pages-hosted websites:
+
+* [NSIDC Data Cookbook](https://nsidc.github.io/NSIDC-Data-Cookbook/): A guide
+  to searching, accessing and working with NSIDC data.
+* [NSIDC Technical Blog](https://nsidc.github.io/NSIDC-Technical-Blog/): A blog
+  by and for NSIDC developers.