first commit

Author: edeleastar

.gitignore

@@ -0,0 +1,2 @@
+json
+public-site

README.md

@@ -0,0 +1,16 @@
+# tutors-starter
+
+A starter course structure for the tutors generator. This course is deployed here:
+
+- <https://tutors-design.netlify.app/course/starter-three.netlify.app>
+
+A local static version of the course can be built as follows:
+
+```
+https://github.com/tutors-sdk/starter-three.git
+npx tutors-html
+```
+
+This will generate a web site in ./public-site.
+
+To deploy the course using [tutors-design](https://github.com/edeleastar/tutors-design), clone this repo to your own github or bitbucket account, and follow [this lab step here](https://tutors-design.netlify.app/lab/tutors-course.netlify.app/topic-00-tutors-next/book-next/03).

course.jpg

@@ -0,0 +1,3 @@
+# Tutors Starter Three
+
+A short description of the course. Normally this will not be visible, unless the course is aggregated into a portfolio of modules

course.md

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "tutors-json": "^1"
+  }
+}

package.json

@@ -0,0 +1,8 @@
+slack: https://tutors-ts-group.slack.com/messages/CCKS0HR0Q
+moodle: https://moodle.wit.ie/course/view.php?id=118143&section=3
+youtube: https://www.youtube.com/playlist?list=PLMW4bgOfD3Dwi6FWirJ3AQtXZ-N_hV3Eo
+zoom: https://zoom.us/
+credits: Your Name Here, WIT
+auth : 0
+ignorepin : 1234
+

properties.yaml

@@ -0,0 +1,3 @@
+# Simple Units
+
+This topic has 2 units - each unit has lectures + lab

topic-01/topic.jpg

@@ -0,0 +1,3 @@
+# Objectives
+
+A few sentences on the purpose of the lab. Avoid bullet points here for formatting reasons.

topic-01/topic.md

@@ -0,0 +1,72 @@
+# Text
+
+It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [inset a link to Google](http://google.com)
+
+
+## Lists
+
+Sometimes you want numbered lists:
+
+1. One
+2. Two
+3. Three
+
+Sometimes you want bullet points:
+
+* Start a line with a star
+* Profit!
+
+Alternatively,
+
+- Dashes work just as well
+- And if you have sub points, put two spaces before the dash or star:
+  - Like this
+  - And this
+
+## Images
+
+If you want a link to a local image, place the image in the `img` folder and then insert a link like this:
+
+![](img/02.jpg)
+
+Alternatively you can directly link to images on the web:
+
+![Image of Yaktocat](https://octodex.github.com/images/yaktocat.png)
+
+The above includes a title.
+
+# Structured documents
+
+Sometimes it's useful to have different levels of headings to structure your documents. Start lines with a `#` to create headings. Multiple `##` in a row denote smaller heading sizes.
+
+### This is a third-tier heading
+
+You can use one `#` all the way up to `######` six for different heading sizes.
+
+If you'd like to quote someone, use the > character before the line:
+
+> Coffee. The finest organic suspension ever devised... I beat the Borg with it.
+> - Captain Janeway
+
+There are many different ways to style code with GitHub's markdown. If you have inline code blocks, wrap them in backticks: `var example = true`.  If you've got a longer block of code, you can indent with four spaces:
+
+    if (isAwesome){
+      return true
+    }
+
+GitHub also supports something called code fencing, which allows for multiple lines without indentation:
+
+~~~
+if (isAwesome){
+  return true
+}
+~~~
+
+And if you'd like to use syntax highlighting, include the language:
+
+~~~javascript
+if (isAwesome){
+  return true
+}
+~~~
+

topic-01/unit-1/book-a/00.Lab-01.md

@@ -0,0 +1,20 @@
+# Tables, Lines and Images
+
+
+Tables can look like this:
+
+Head 1 | Head 2
+------ | -------
+cell 1 | cell 2
+cell 3 | cell 4
+
+
+---
+
+A horizontal rules above and below
+
+---
+
+Some more images:
+
+![](img/01.jpg)

topic-01/unit-1/book-a/01.01.md

@@ -0,0 +1,65 @@
+# Links and Code Blocks
+
+You can inert links in bullet points:
+
+- <http://github.com>
+- <http://bitbucket.dom>
+
+You can also insert links to other steps:
+
+- [Step 01](#/01)
+- [Step 02](#/02)
+- [Step 03](#/03)
+- [Step 04](#/04)
+
+More Code Block examples
+
+~~~
+  publish(path, course) {
+    const basePath = '../' + path + '/' + this.folder;
+    futils.initEmptyPath(basePath);
+
+    this.resources = this.talks.concat(this.labs);
+    futils.copyFileToFolder(this.img, basePath);
+    futils.writeFile(basePath + '/index.html', nunjucks.render('topic.html', this));
+
+    futils.writeFile(basePath + '/ajaxlabel.html',
+        nunjucks.render('ajaxlabel.html',
+            { url: this.url.substring(5) + '/' + this.folder }));
+    futils.writeFile(basePath + '/indexmoodle.html', nunjucks.render('indexmoodle.html', this));
+
+    console.log(this.title);
+    this.publishTalks(basePath);
+    this.publishLabs(basePath, course);
+  }
+~~~
+
+This was autodetected as javascript. This one is html:
+
+~~~
+<div class="ui segment pushable">
+  <div class="ui inverted labeled icon left inline vertical sidebar menu">
+    {% for resource in course.allLabs.resources %}
+      {% if resource.title == title %}
+        <a class="active item" href="../../{{resource.parentFolder}}/{{resource.folder}}/{{resource.link}}">
+          {{resource.title}}
+        </a>
+      {% else %}
+        <a class="item" href="../../{{resource.parentFolder}}/{{resource.folder}}/{{resource.link}}">
+          {{resource.title}}
+        </a>
+      {% endif %}
+    {% endfor %}
+  </div>
+  <div class="pusher">
+    <div class="ui basic segment">
+      <br>
+      {% for chapter in chapters %}
+      <div  class="ui tab segment lab" data-tab="{{chapter.shortTitle}}">
+        {{ chapter.content }}
+      </div>
+     {% endfor %}
+    </div>
+  </div>
+</div>
+~~~

topic-01/unit-1/book-a/02.02.md

@@ -0,0 +1,9 @@
+# Images
+
+Image without a title:
+
+![](img/04.jpg)
+
+Image with a title:
+
+![This is a Stone Arch](img/03.jpg)

topic-01/unit-1/book-a/03.03.md

@@ -0,0 +1,62 @@
+# Katex
+
+Larex support via the [Katex](https://katex.org/) Library.
+
+## Example 0
+
+```asciimath
+E=mc^2
+```
+
+## Example 1
+
+```latex
+c = \pm\sqrt{a^2 + b^2}
+```
+
+## Example 2
+
+
+```latex
+x=\frac{ -b\pm\sqrt{ b^2-4ac } } {2a}
+```
+
+## Example 3
+
+
+```latex
+f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
+```
+
+## Example 4
+
+
+```asciimath
+g(x) = 3x^4 + 2x^2
+```
+
+## Example 5
+
+
+```latex
+
+x=\frac{ -b\pm\sqrt{ b^2-4ac } } {2a}
+
+\sum_{i=1}^n i^3 = \left( \frac{n(g(n)+1)} 2 \right) ^2
+
+c = \pm\sqrt{a^2 + b^2}
+```
+
+## Example 6
+
+~~~latex
+
+\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
+
+~~~
+
+## Example 7
+
+~~~latex
+1 +  \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad \text{for }\lvert q\rvert<1.
+~~~

topic-01/unit-1/book-a/04.04.md

@@ -0,0 +1,19 @@
+# Exercises & Archives
+
+You can link to zipped archives:
+
+- [Solutions](./archives/archive.zip)
+
+This archive must be placed in the `archives` folder as shown above.
+
+## Exercise 1:
+
+Instructions for exercise 1.
+
+## Exercise 2:
+
+Instructions for exercise 2.
+
+## Exercise 3:
+
+Instructions for exercise 3.

topic-01/unit-1/book-a/05.05.md

@@ -0,0 +1,3 @@
+Lecture 1
+
+A short summary of the talk, no more than two sentences. Avoid bullet points or links for formatting reasons.

topic-01/unit-1/book-a/06.Exercises.md

@@ -0,0 +1,3 @@
+Lecture 2
+
+A short summary of the talk, no more than two sentences. Avoid bullet points or links for formatting reasons.

topic-01/unit-1/book-a/archives/archive.zip

@@ -0,0 +1 @@
+Unit 1 Title

topic-01/unit-1/book-a/img/01.jpg

@@ -0,0 +1,3 @@
+# Objectives
+
+A few sentences on the purpose of the lab. Avoid bullet points here for formatting reasons.

topic-01/unit-1/book-a/img/02.jpg

@@ -0,0 +1,71 @@
+# Text
+
+It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [inset a link to Google](http://google.com)
+
+## Lists
+
+Sometimes you want numbered lists:
+
+1. One
+2. Two
+3. Three
+
+Sometimes you want bullet points:
+
+* Start a line with a star
+* Profit!
+
+Alternatively,
+
+- Dashes work just as well
+- And if you have sub points, put two spaces before the dash or star:
+  - Like this
+  - And this
+
+## Images
+
+If you want a link to a local image, place the image in the `img` folder and then insert a link like this:
+
+![](img/02.jpg)
+
+Alternatively you can directly link to images on the web:
+
+![Image of Yaktocat](https://octodex.github.com/images/yaktocat.png)
+
+The above includes a title.
+
+# Structured documents
+
+Sometimes it's useful to have different levels of headings to structure your documents. Start lines with a `#` to create headings. Multiple `##` in a row denote smaller heading sizes.
+
+### This is a third-tier heading
+
+You can use one `#` all the way up to `######` six for different heading sizes.
+
+If you'd like to quote someone, use the > character before the line:
+
+> Coffee. The finest organic suspension ever devised... I beat the Borg with it.
+> - Captain Janeway
+
+There are many different ways to style code with GitHub's markdown. If you have inline code blocks, wrap them in backticks: `var example = true`.  If you've got a longer block of code, you can indent with four spaces:
+
+    if (isAwesome){
+      return true
+    }
+
+GitHub also supports something called code fencing, which allows for multiple lines without indentation:
+
+~~~
+if (isAwesome){
+  return true
+}
+~~~
+
+And if you'd like to use syntax highlighting, include the language:
+
+~~~javascript
+if (isAwesome){
+  return true
+}
+~~~
+