create syllabus for reference

Author: brownsarahm

.github/workflows/publish.yml

@@ -31,6 +31,15 @@ jobs:
         mv _build/pdf/book.pdf _build/html/coursemanual.pdf
         jupyter-book build .
 
+    # Build the syllabus only
+    - name: Build the syllaubs
+      run: |
+        cd syllabus/
+        jupyter-book build .  --toc _toc_syllabus.yml --builder pdfhtml --all
+        mv _build/pdf/book.pdf ../_build/html/syllabus.pdf
+
+
+
     # Push the book's html to github-pages
     - name: GitHub Pages action
       uses: peaceiris/actions-gh-pages@v3.6.1

syllabus/_config.yml

@@ -0,0 +1,61 @@
+# Book settings
+title: Introduction to Computer Systems
+author: Professor Sarah M Brown
+logo: logo.png
+
+html:
+  favicon                   : ""  # A path to a favicon image
+  use_edit_page_button      : true  # Whether to add an "edit this page" button to pages. If `true`, repository information in repository: must be filled in
+  use_repository_button     : true  # Whether to add a link to your repository button
+  use_issues_button         : true  # Whether to add an "open an issue" button left navbar.
+  extra_footer              : ""  # Will be displayed underneath the footer.
+  home_page_in_navbar       : true
+  use_multitoc_numbering: false
+  # extra_navbar              : Download complete <a href="">PDF</a> # Will be displayed underneath the
+
+
+repository:
+  url                       : https://github.com/introcompsys/fall2022 # The URL to your book's repository
+  path_to_book              : ""  # A path to your book's folder, relative to the repository root.
+  branch                    : main  # Which branch of the repository should be used when creating links
+
+
+latex:
+  latex_documents:
+    targetname: book.tex
+
+exclude_patterns            : ['_data/*',  README.md, ignore/*]  # Patterns to skip when building the book. Can be glob-style (e.g. "*skip.ipynb")
+
+#######################################################################################
+# Execution settings
+execute:
+  execute_notebooks         : auto  # Whether to execute notebooks at build time. Must be one of ("auto", "force", "cache", "off")
+  cache                     : ""  # A path to the jupyter cache that will be used to store execution artifacs. Defaults to `_build/.jupyter_cache/`
+  exclude_patterns          : []  # A list of patterns to *skip* in execution (e.g. a notebook that takes a really long time)
+  allow_errors              : true
+
+
+
+parse:
+  myst_enable_extensions: # default extensions to enable in the myst parser. See https://myst-parser.readthedocs.io/en/latest/using/syntax-optional.html
+    - amsmath
+    - colon_fence
+    - deflist
+    - dollarmath
+    - html_admonition
+    - html_image
+    - linkify
+    - replacements
+    - smartquotes
+    - substitution
+  myst_substitutions:
+    time: MW 4:30-5:45
+    location: Engineering Building Room 045
+    repo_name: FIXME
+    repo_commits: |
+      [commit history](https://github.com/introcompsys/fall2022/commits)
+    repo_issue: |
+      [issue](https://github.com/introcompsys/fall2022/issues)
+    bssite: |
+      [Brightspace site](https://brightspace.uri.edu/d2l/home/202430)
+    ghinstructors: fa22instructors

syllabus/_toc_syllabus.yml

@@ -0,0 +1,14 @@
+format: jb-book
+root: index
+parts:
+  - caption: Syllabus
+    chapters:
+    - file: syllabus/about
+    - file: syllabus/tools
+    - file: syllabus/grading
+    - file: syllabus/contract
+    - file: syllabus/schedule
+    - file: syllabus/policies
+    - file: syllabus/uri_resources
+    - file: syllabus/uri_statements
+    - file: syllabus/communication