mirror of
https://github.com/TeachBooks/manual.git
synced 2026-11-12 22:35:51 +00:00
Merge pull request #48 from TeachBooks/workshop-morning
update intro-book page
This commit is contained in:
Robert Lanzafame
GitHub
commit
ff0b11e795
3 changed files with 406 additions and 10 deletions
|
|
@ -14,12 +14,34 @@ Never seen a TeachBook before? Here's a small demo of our MUDE-book!
|
|||
</div>
|
||||
</div>
|
||||
|
||||
So what are you looking at? It's a website generated with the [Jupyter Book package](https://jupyterbook.org/). Various extensions have been added to improve the student-experience, especially for technical topics! The actual website you're looking at now is a JupyterBook. With TeachBooks we aim to make it easy to collaboratively use it, even if you've little experience with the software package which is part of it.
|
||||
So what are you looking at? It's a website generated with the [Jupyter Book package](https://jupyterbook.org/). Various extensions have been added to improve the student-experience, especially for technical topics! The actual website you're looking at now is a Jupyter Book. With TeachBooks we aim to make it easy to collaboratively use it, even if you've little experience with the software package which is part of it.
|
||||
|
||||
The source files of this book consists of three parts:
|
||||
1. A configuration file to define functionalities, `_config.yml`
|
||||
2. A table of contents file to list which files should endup in the book, `_toc.yml`
|
||||
3. Content for your book! Text-based files which allows you to embed figures, videos, math and interactive elements.
|
||||
## Three Key Ingredients
|
||||
|
||||
To create a Jupyter Book, three key ingredients are needed:
|
||||
|
||||
1. A **configuration file** to define functionalities, `_config.yml`
|
||||
2. A **table of contents** file to list which files should end up in the book, `_toc.yml`, as well as define its structure
|
||||
3. **Content** for your book! Text-based files which allows you to embed figures, videos, math and interactive elements.
|
||||
|
||||
The files are typically organized together in a files structure like this:
|
||||
|
||||
```
|
||||
└── my_book_directory/
|
||||
├── README.md
|
||||
├── requirements.txt
|
||||
└── book/
|
||||
└── _config.yml
|
||||
└── _toc.yml
|
||||
└── contents/
|
||||
└── intro.md
|
||||
└── chapter1.md
|
||||
└── chapter2.ipynb
|
||||
└── images/
|
||||
└── figure1.png
|
||||
```
|
||||
|
||||
Note the arrangement of the 3 key book ingredients in a subdirectory called `book/`; this is where you should focus when you are just getting started with TeachBooks and are making your first book. Additional files can be used to control the book-building process, and these are typically stored _outside_ the `book/` directory to keep the book contents separate. For now, all you need to understand that everything needed to create a book can be collected in a single top-level directory (`my_book_directory/`, in this case), and this directory is what becomes the collection of files in our Git **repository** (described elsewhere).
|
||||
|
||||
`````{admonition} Text-based files? yml? What is that?!
|
||||
:class: tip, dropdown
|
||||
|
|
@ -46,15 +68,39 @@ You can see quite clearly that a number of files are listed, and that they are o
|
|||
````
|
||||
`````
|
||||
|
||||
A book is made by by writing content in text-based files such as Markdown (`*.md`), Jupyter Notebooks (`*.ipynb`), etc. After that, software is used to "parse" these files and create the final book (e.g., Jupyter Book)
|
||||
## How is a book made?
|
||||
|
||||
```{admonition} Comparing and Contrasting to LaTeX
|
||||
A book is made by by writing content in text-based files such as Markdown (`*.md`), Jupyter Notebooks (`*.ipynb`), etc. After that, software is used to "parse" these files and create the final book (e.g., Jupyter Book). Fortunately when getting started you don't need to worry about the software because TeachBooks has set up GitHub tools for you that take care of this process automatically! The process is illustrated in the diagram below.
|
||||
|
||||
Have you ever used LaTeX? It turns out there are a lot of similarities with this document system. Here is a quick list:
|
||||
```{figure} figures/intro-book.svg
|
||||
---
|
||||
width: 700px
|
||||
---
|
||||
The process of building a book with TeachBooks. When just getting started, TeachBooks tools enables you to focus on what matters most: learning to write content for your book!
|
||||
```
|
||||
|
||||
```{admonition} Familiar with LaTeX? There are similarities!
|
||||
:class: dropdown
|
||||
|
||||
Have you ever used LaTeX? It turns out there are a lot of similarities with Jupyter Book. Here is a quick list:
|
||||
1. Writing "source code" in text-based files (i.e., `*.tex` versus `*.md`, `*.ipynb`, etc) that is generally easy to read without the markup and uses special functions to format rich document objects (e.g., tables, figures, etc).
|
||||
2. The "book" is created by using a piece of software that parses the source code and creates the final document (a `*.pdf` versus a `*.html` for Jupyter Book).
|
||||
3. Creating the document structure using a list of files that contain source code that automatically generates the Table of Contents and Index..
|
||||
4. Sometimes you can spend more time than you like troubleshooting "bugs" that turn out to be simple syntax errors.
|
||||
|
||||
If you've used LaTeX before, it will be relatively easy to learn to use a Jupyter Book.
|
||||
```
|
||||
|
||||
Let's see how these books are made!
|
||||
## Why are Git and GitHub Important?
|
||||
|
||||
The fun part is the collaborative aspect of TeachBooks! However, the amount of software required _when doing this by yourself_ can be intimidating. Git and GitHub are tools used by TeachBooks to make this process as smooth as possible for newcomers.
|
||||
|
||||
There are three reasons why Git and GitHub are important for TeachBooks:
|
||||
|
||||
1. **Version control**: Git is a version control system that allows you to track changes to your files over time. This is especially useful when you're working with others on a book, as it allows you to see who made what changes and when.
|
||||
2. **Collaboration**: GitHub is a company that provides a wide array of online tools. These _augment_ the version control features incorporated directly in Git. In short, tools at `github.com` allow you to share your files with others and work on them together. This is especially useful when you're working on a book with multiple authors, as it allows you to easily share your work and collaborate.
|
||||
3. **Automation**: GitHub provides a number of tools that can help automate the process of building your book. TeachBooks has carefully developed a number of these tools specifically to support teachers and students in the process of creating and sharing educational content.
|
||||
|
||||
## What's next?
|
||||
|
||||
The following pages will introduce you to a standard "workflow" for editing a book, which is focused entirely in the "source code" of a book (the first box in the diagram above). After we cover this, you'll be ready to make your first book!
|
||||
|
|
|
|||
350
book/intro/figures/intro-book.svg
Normal file
350
book/intro/figures/intro-book.svg
Normal file
|
|
@ -0,0 +1,350 @@
|
|||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<!-- Created with Inkscape (http://www.inkscape.org/) -->
|
||||
|
||||
<svg
|
||||
width="328.00415mm"
|
||||
height="116.89093mm"
|
||||
viewBox="0 0 1239.7008 441.7925"
|
||||
version="1.1"
|
||||
id="svg1"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
xmlns:svg="http://www.w3.org/2000/svg">
|
||||
<defs
|
||||
id="defs1">
|
||||
<rect
|
||||
x="855.04938"
|
||||
y="772.0968"
|
||||
width="0"
|
||||
height="48.495338"
|
||||
id="rect29" />
|
||||
<rect
|
||||
x="-14.038124"
|
||||
y="903.54468"
|
||||
width="1069.4498"
|
||||
height="246.30527"
|
||||
id="rect19" />
|
||||
<linearGradient
|
||||
id="swatch7">
|
||||
<stop
|
||||
style="stop-color:#000000;stop-opacity:1;"
|
||||
offset="0"
|
||||
id="stop7" />
|
||||
</linearGradient>
|
||||
<marker
|
||||
style="overflow:visible"
|
||||
id="marker4-4-1"
|
||||
refX="0"
|
||||
refY="0"
|
||||
orient="auto-start-reverse"
|
||||
markerWidth="1"
|
||||
markerHeight="1"
|
||||
viewBox="0 0 1 1"
|
||||
preserveAspectRatio="xMidYMid">
|
||||
<path
|
||||
style="fill:none;stroke:context-stroke;stroke-width:1;stroke-linecap:round"
|
||||
d="M 3,-3 0,0 3,3"
|
||||
transform="rotate(180,0.125,0)"
|
||||
id="path4-9-32" />
|
||||
</marker>
|
||||
<marker
|
||||
style="overflow:visible"
|
||||
id="marker4-4-4-95"
|
||||
refX="0"
|
||||
refY="0"
|
||||
orient="auto-start-reverse"
|
||||
markerWidth="1"
|
||||
markerHeight="1"
|
||||
viewBox="0 0 1 1"
|
||||
preserveAspectRatio="xMidYMid">
|
||||
<path
|
||||
style="fill:none;stroke:context-stroke;stroke-width:1;stroke-linecap:round"
|
||||
d="M 3,-3 0,0 3,3"
|
||||
transform="rotate(180,0.125,0)"
|
||||
id="path4-9-3-8" />
|
||||
</marker>
|
||||
<marker
|
||||
style="overflow:visible"
|
||||
id="marker4-4-2-8"
|
||||
refX="0"
|
||||
refY="0"
|
||||
orient="auto-start-reverse"
|
||||
markerWidth="1"
|
||||
markerHeight="1"
|
||||
viewBox="0 0 1 1"
|
||||
preserveAspectRatio="xMidYMid">
|
||||
<path
|
||||
style="fill:none;stroke:context-stroke;stroke-width:1;stroke-linecap:round"
|
||||
d="M 3,-3 0,0 3,3"
|
||||
transform="rotate(180,0.125,0)"
|
||||
id="path4-9-4-0" />
|
||||
</marker>
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient1"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(0.75152949,0,0,0.67302847,1183.5248,88.848777)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient2"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(0.75177303,0,0,0.64991433,1183.4601,90.383898)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient6"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(0.75182225,0,0,0.6452922,1183.447,90.690792)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient7"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(0.75162636,0,0,0.66378216,1505.0997,-102.68981)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient8"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(1.2756681,0,0,0.50207641,1134.8588,176.12325)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
<linearGradient
|
||||
xlink:href="#swatch7"
|
||||
id="linearGradient10"
|
||||
gradientUnits="userSpaceOnUse"
|
||||
gradientTransform="matrix(2.1328887,0,0,0.21024579,896.86559,157.30107)"
|
||||
x1="91.00753"
|
||||
y1="204.44643"
|
||||
x2="440.43915"
|
||||
y2="204.44643" />
|
||||
</defs>
|
||||
<g
|
||||
id="g36"
|
||||
transform="translate(-58.905582,-716.40082)">
|
||||
<g
|
||||
id="g35"
|
||||
style="display:inline"
|
||||
transform="translate(-1256.1396,-20.75745)">
|
||||
<g
|
||||
id="g10-8"
|
||||
transform="translate(-443.02906,835.34419)"
|
||||
style="display:inline">
|
||||
<g
|
||||
id="g45-2"
|
||||
transform="translate(510.79547,-230.4935)"
|
||||
style="stroke-width:3.77953;stroke-dasharray:none">
|
||||
<rect
|
||||
style="fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient1);stroke-width:4.95847;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-3"
|
||||
width="262.60815"
|
||||
height="183.32053"
|
||||
x="1251.9197"
|
||||
y="134.78676"
|
||||
ry="17.516886" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1382.3889"
|
||||
y="189.92847"
|
||||
id="text45-2"><tspan
|
||||
id="tspan21"
|
||||
x="1382.3889"
|
||||
y="189.92847"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">Source Code</tspan><tspan
|
||||
id="tspan23"
|
||||
x="1382.3889"
|
||||
y="236.59509"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">(Repository)</tspan><tspan
|
||||
x="1382.3889"
|
||||
y="283.26172"
|
||||
id="tspan25"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:29.3333px;font-family:'Courier New';-inkscape-font-specification:'Courier New, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">*.md, *.ipynb</tspan></text>
|
||||
</g>
|
||||
<g
|
||||
id="g45-7-6"
|
||||
transform="translate(1480.768,-225.14112)"
|
||||
style="stroke-width:3.77953;stroke-dasharray:none">
|
||||
<rect
|
||||
style="fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient2);stroke-width:4.87337;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-1-4"
|
||||
width="262.69327"
|
||||
height="177.02466"
|
||||
x="1251.8771"
|
||||
y="134.7442"
|
||||
ry="16.915295" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-size:37.3333px;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1388.7699"
|
||||
y="212.89993"
|
||||
id="text45-7-6"><tspan
|
||||
x="1388.7699"
|
||||
y="212.89993"
|
||||
id="tspan8-1"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">Online Book</tspan><tspan
|
||||
x="1388.7699"
|
||||
y="259.56656"
|
||||
id="tspan9-3"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">(webserver)</tspan></text>
|
||||
</g>
|
||||
<g
|
||||
id="g45-3-6"
|
||||
transform="translate(1155.396,-225.30267)"
|
||||
style="stroke-width:3.77953;stroke-dasharray:none">
|
||||
<rect
|
||||
style="fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient6);stroke-width:4.85617;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-0-4"
|
||||
width="262.71048"
|
||||
height="175.76567"
|
||||
x="1251.8685"
|
||||
y="134.7356"
|
||||
ry="16.794992" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-size:37.3333px;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1382.389"
|
||||
y="209.07137"
|
||||
id="text45-0-65"><tspan
|
||||
x="1382.389"
|
||||
y="209.07137"
|
||||
id="tspan31"><tspan
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:'Courier New';-inkscape-font-specification:'Courier New, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal"
|
||||
id="tspan28">html</tspan> <tspan
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal"
|
||||
id="tspan34">files</tspan></tspan><tspan
|
||||
x="1382.389"
|
||||
y="256.48807"
|
||||
id="tspan29"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">(website)</tspan></text>
|
||||
</g>
|
||||
<g
|
||||
id="g11-0"
|
||||
style="stroke-width:3.77953;stroke-dasharray:none"
|
||||
transform="translate(510.75613,-36.94968)">
|
||||
<rect
|
||||
style="fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient7);stroke-width:4.92461;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-5-0"
|
||||
width="262.64203"
|
||||
height="180.802"
|
||||
x="1573.5034"
|
||||
y="-57.382954"
|
||||
ry="17.276232" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-size:37.3333px;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1706.542"
|
||||
y="2.3280809"
|
||||
id="text45-1-7"><tspan
|
||||
x="1706.542"
|
||||
y="2.3280809"
|
||||
id="tspan5-0"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:29.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">Markup</tspan><tspan
|
||||
x="1706.542"
|
||||
y="48.994709"
|
||||
id="tspan6-6"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:29.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">Software</tspan><tspan
|
||||
x="1706.542"
|
||||
y="95.661331"
|
||||
id="tspan26"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:29.3333px;font-family:'Courier New';-inkscape-font-specification:'Courier New, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">jupyter-book</tspan></text>
|
||||
</g>
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:6.37227;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker4-4-1)"
|
||||
d="m 2349.7386,-5.6622197 h 45.0073"
|
||||
id="path52-4-7" />
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:6.37227;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker4-4-4-95)"
|
||||
d="m 2027.9658,-6.1471948 h 45.0073"
|
||||
id="path52-4-9-7" />
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:6.37227;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker4-4-2-8)"
|
||||
d="m 2674.0343,-4.1283267 h 45.0073"
|
||||
id="path52-4-3-3" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
transform="translate(1699.1687,-814.58674)"
|
||||
id="text29"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:'Courier New';-inkscape-font-specification:'Courier New, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;text-align:center;white-space:pre;shape-inside:url(#rect29);opacity:0;fill:#3b60e4;fill-opacity:1;stroke:#3b60e4;stroke-opacity:1" />
|
||||
</g>
|
||||
<g
|
||||
id="g45-2-6"
|
||||
transform="translate(66.880941,829.0118)"
|
||||
style="display:inline;stroke-width:3.77953;stroke-dasharray:none">
|
||||
<rect
|
||||
style="fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient8);stroke-width:5.57972;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-3-5"
|
||||
width="445.7587"
|
||||
height="136.75632"
|
||||
x="1250.9541"
|
||||
y="210.39278"
|
||||
ry="13.067522" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-size:37.3333px;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1475.551"
|
||||
y="269.05243"
|
||||
id="text45-2-1"><tspan
|
||||
x="1475.551"
|
||||
y="269.05243"
|
||||
id="tspan19"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">You edit text-based files</tspan><tspan
|
||||
x="1475.551"
|
||||
y="315.71906"
|
||||
id="tspan32"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal">(source code)</tspan></text>
|
||||
<text
|
||||
xml:space="preserve"
|
||||
transform="translate(1189.2586,-817.18775)"
|
||||
id="text19"
|
||||
style="font-size:29.3333px;font-family:Sans;-inkscape-font-specification:'Sans, Normal';text-align:center;white-space:pre;shape-inside:url(#rect19);opacity:0;fill:#3b60e4;fill-opacity:1;stroke:#3b60e4;stroke-opacity:1" />
|
||||
</g>
|
||||
<rect
|
||||
style="display:inline;fill:#85a5ff;fill-opacity:1;stroke:url(#linearGradient10);stroke-width:4.66881;stroke-linejoin:miter;stroke-dasharray:none"
|
||||
id="rect1-1-0-4-0"
|
||||
width="745.29883"
|
||||
height="57.267071"
|
||||
x="1090.9745"
|
||||
y="171.65152"
|
||||
ry="5.4720592"
|
||||
transform="translate(712.75782,905.66944)" />
|
||||
<text
|
||||
xml:space="preserve"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:37.3333px;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;text-align:center;text-anchor:middle;display:inline;fill:#000000;fill-opacity:1;stroke:none;stroke-width:3.77953;stroke-dasharray:none;stroke-opacity:1"
|
||||
x="1464.0653"
|
||||
y="214.17613"
|
||||
id="text45-0-65-5"
|
||||
transform="translate(712.75782,905.66944)"><tspan
|
||||
id="tspan35"
|
||||
x="1464.0653"
|
||||
y="214.17613">TeachBooks tools and GitHub do the rest!</tspan></text>
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#3b60e4;stroke-width:12.6442;stroke-dasharray:none;stroke-opacity:1"
|
||||
d="m 2547.6959,946.20592 v 36.15346 h -903.2871 v -36.15346"
|
||||
id="path58-3" />
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#3b60e4;stroke-width:11.8218;stroke-dasharray:none;stroke-opacity:1"
|
||||
d="m 2082.4994,1066.7287 0.2586,-77.80903"
|
||||
id="path58-3-4" />
|
||||
<path
|
||||
style="fill:none;fill-opacity:1;stroke:#3b60e4;stroke-width:12.6442;stroke-dasharray:none;stroke-opacity:1"
|
||||
d="m 1448.766,1025.3091 0.2576,-89.33348"
|
||||
id="path58-3-4-3" />
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 17 KiB |
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
The fun part is the collaborative aspect of TeachBooks! Because all the files are text-based, they're well suited for using git. That allows us to use the version-control principles of git to its best!
|
||||
|
||||
Assuming you've a book (well make that happen soon!) and you're ready to collaborate, the process is as follows:
|
||||
Assuming you have a book (well make that happen soon!) and you're ready to collaborate, the process is as follows:
|
||||
|
||||
## 1 get an idea
|
||||
```{figure} figures/idea.png
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue