Before you keep reading...

Runestone Academy can only continue if we get support from individuals like you. As a student you are well aware of the high cost of textbooks. Our mission is to provide great books to you for free, but we ask that you consider a $10 donation, more if you can or less if $10 is a burden.

Support Runestone Academy Today

Before you keep reading...

Making great stuff takes time and $$. If you appreciate the book you are reading now and want to keep quality materials free for other students please consider a donation to Runestone Academy. We ask that you consider a $10 donation, but if you can give more thats great, if $10 is too much for your budget we would be happy with whatever you can afford as a show of support.

Support Runestone Academy Today

SPARCC 2020

SECTION 1: Introduction

Congratulations! If you can see this file you have probably successfully run the runestone init command. If you are looking at this as a source file you should now run runestone build to generate html files. Once you have run the build command you can run runestone serve and then view this in your browser at http://localhost:8000

This is just a sample of what you can do. The index.rst file is the table of contents for your entire project. You can put all of your writing in the index, or you can include additional rst files. Those files may even be in subdirectories that you can reference using a relative path.

• Andrew
  • Multiple Choice Questions
  • Fill in the Blank Questions
  • Matching Questions
  • Videos
  • Code
• Hannah
• Zosha
• Sarah
• Laura

Section 2: Links

Runestone uses the restructuredText (rst) markup language. We chose this over markdown largely because rst is extensible. Nearly all of the basic markup tasks are already handled by restructuredText. You should check out the docs for the basics of restructuredText (link below). Our extensions are all for the interactive elements. One key hint about restructuredText: Its like Python – indentation matters!

• restructuredText Docs

• Runestone Docs

• Join the discussion on our Google Group

• Tell us about problems on Github

SECTION 3: Sample Directives

ActiveCode

print("My first program adds a list of numbers") myList = [2, 4, 6, 8, 10] total = 0 for num in myList: total = total + num print(total)

Multiple Choice

Q-2: Which colors might be found in a rainbow? (choose all that are correct)

• red
• Red is a definitely on of the colors.
• yellow
• Yes, yellow is correct.
• black
• Remember the acronym...ROY G BIV. B stands for blue.
• green
• Yes, green is one of the colors.

These are just two of the many interactive components for writing online course materials. You can see examples of all of them On our Example Page

Now feel free to modify this file to start creating your own interactive page.

Section 4: Theme

You can override the style rules in the default theme by adding css rules to a file named theme-overrides.css (the filename is important - this will replace an existing file). Make sure the file’s directory is part of the html_static_path. You can do so by placing it in a folder _static, then modifying html_static_path in conf.py to include that folder:

html_static_path =  runestone_static_dirs() + ['_static']

If you want to do more significant changes to the theme, you should copy the files in the runestone/common/project/template/sphinx_bootstrap to a directory like _templates/my_theme. Then make sure these values are set in conf.py:

html_theme_path = ["_templates"]
html_theme = 'my_theme'

You have attempted of activities on this page