add table of configs

Author: hamelsmu

nbs/tutorials/blogging.ipynb

@@ -119,7 +119,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "ff0d4a70-8f9d-4920-ab45-11888c839686",
+   "id": "79f1e2c2-aa94-4ef5-8249-0eb5c030452a",
    "metadata": {},
    "source": [
     "8. Update the following files: \n",
@@ -128,8 +128,59 @@
     "- `./about.qmd`: Add some information about yourself.\n",
     "- `./profile.jpg`: optionally change the profile picture.\n",
     "\n",
-    "9. Preview your site with the command `quarto preview`, and make any necessary adjustments and fix for broken links or Jekyll shortcodes (things with `{% ... %}`) that need to be converted to Quarto.  Search the [the Quarto documentation](https://quarto.org/) if you need help locating specific Quarto features.\n",
-    "\n",
+    "9. Preview your site with the command `quarto preview`, and make any necessary adjustments and fix for broken links or Jekyll shortcodes (things with `{% ... %}`) that need to be converted to Quarto.  Search the [the Quarto documentation](https://quarto.org/) if you need help locating specific Quarto features."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3f00ffc1-295a-4de5-b71f-92cde47d3a84",
+   "metadata": {},
+   "source": [
+    "### Configuration Options: fastpages vs. Quarto\n",
+    "\n",
+    "fastpages (which was based on Jekyll) and Quarto offer different kinds of options and configurations for individual posts and at a site level.  Below are some tables that organize some of the most important features of fastpages and how it maps to Quarto.  Each link in the last column is specific to the relevant feature.\n",
+    "\n",
+    "#### Post Level Front Matter\n",
+    "\n",
+    "Jekyll Front Matter | Quarto | Notes\n",
+    "-- | -- | --\n",
+    "toc: false | Same | There are more options in the [Quarto docs](https://quarto.org/docs/reference/formats/pdf.html#table-of-contents)\n",
+    "badges: true | n/a | No support yet\n",
+    "comments: true | see notes | [Quarto docs](https://quarto.org/docs/output-formats/html-basics.html#commenting)\n",
+    "categories: [fastpages, jupyter] | Same | [Quarto docs](https://quarto.org/docs/websites/website-listings.html#categories)\n",
+    "image: images/some_folder/your_image.png | Same | [Quarto docs](https://quarto.org/docs/websites/website-listings.html#listing-fields)\n",
+    "hide: false | draft: true | [Quarto docs](https://quarto.org/docs/websites/website-blog.html#drafts)\n",
+    "search_exclude: true | see notes | [Quarto docs](https://quarto.org/docs/websites/website-search.html#disabling-search)\n",
+    "title | Same |  \n",
+    "description | Same |  \n",
+    "sticky_rank | Not supported | [Quarto docs](https://quarto.org/docs/websites/website-listings.html#sorting-items)\n",
+    "\n",
+    "\n",
+    "\n",
+    "\n",
+    "#### Site Level Options\n",
+    "\n",
+    "Jekyll site config | Quarto | Notes\n",
+    "-- | -- | --\n",
+    "title | see notes | [Quarto docs](https://quarto.org/docs/websites/#getting-started)\n",
+    "description | see notes |  [Quarto docs](https://quarto.org/docs/websites/website-tools.html)\n",
+    "github_repo | see notes |   [Quarto docs](https://quarto.org/docs/websites/website-navigation.html#top-navigation)\n",
+    "url | n/a | Don't need this\n",
+    "baseurl | n/a | Don't need this\n",
+    "twitter_username | search page in notes for \"twitter\" | [Quarto docs](https://quarto.org/docs/websites/website-navigation.html#top-navigation)\n",
+    "use_math | see notes  | [Quarto docs](https://quarto.org/docs/output-formats/html-basics.html#latex-equations)\n",
+    "google_analytics | website:  google-analytics: \"UA-XXXXXXXX\" | [Quarto docs](https://quarto.org/docs/websites/website-tools.html#google-analytics)\n",
+    "show_image | n/a | [Quarto docs](https://quarto.org/docs/reference/formats/html.html#layout)\n",
+    "show_tags | see title-block-categories of page in notes | [Quarto docs](https://quarto.org/docs/reference/formats/html.html#layout)\n",
+    "pagination | website:  page-navigation: true | [Quarto docs](https://quarto.org/docs/websites/website-navigation.html#page-navigation)\n",
+    "annotations | comments:  hypothesis: ... | [Quarto docs](https://quarto.org/docs/output-formats/html-basics.html#commenting)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8ee5b80e-7931-4d03-8f3e-c8010c36279c",
+   "metadata": {},
+   "source": [
     "## Publishing Your Blog\n",
     "\n",
     "::: {.callout-warning}\n",