Skip to content

Commit 35a95e1

Browse files
committed
finished formatting
1 parent 74cb261 commit 35a95e1

29 files changed

+378
-89
lines changed

_static/custom.css

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
/* Match admonition text to regular body size */
2+
.admonition,
3+
.admonition p,
4+
.admonition .admonition-title {
5+
font-size: inherit;
6+
}
7+
/* Increase specificity so it overrides the theme defaults */
8+
.admonition > .admonition-title {
9+
font-size: inherit !important;
10+
font-weight: 700 !important;
11+
}
12+
/* Ensure nested admonition titles also pick up weight */
13+
.admonition .admonition-title {
14+
font-weight: 700 !important;
15+
}
16+
17+
/* Make topic directive text match body size */
18+
.topic,
19+
.topic p,
20+
.topic .topic-title {
21+
font-size: inherit;
22+
}
23+
/* Increase specificity to override theme defaults */
24+
.topic > .topic-title {
25+
font-size: inherit !important;
26+
font-weight: 700;
27+
}
28+
29+
/* Make code blocks match body font size */
30+
pre,
31+
.highlight pre,
32+
.literal-block {
33+
font-size: inherit;
34+
}
35+
36+
/* Make inline code match body font size */
37+
code,
38+
.docutils.literal {
39+
font-size: inherit;
40+
}
41+
42+
/* Heading color tweaks */
43+
h1 {
44+
color: #ff9100 !important;
45+
}
46+
h2 {
47+
color: #ffab3c !important;
48+
}
49+
h3 {
50+
color: #ffba5f !important;
51+
}
52+
h4 {
53+
color: #fbca89 !important;
54+
}
55+
56+
/* Sidebar background (covers gutter left of nav) */
57+
.sidebar-drawer,
58+
.sidebar,
59+
.sidebar-container,
60+
.sidebar-scroll {
61+
background: #ffdfb4 !important;
62+
}
63+
.sidebar-search-container {
64+
position: relative !important;
65+
background: linear-gradient(
66+
90deg,
67+
rgba(251, 202, 137, 0) 0%,
68+
#fbca89 var(--sidebar-item-spacing-horizontal),
69+
#fbca89 100%
70+
) !important;
71+
}
72+
.sidebar-search {
73+
background: linear-gradient(
74+
90deg,
75+
rgba(239, 239, 244, 0) 0%,
76+
#efeff4 var(--sidebar-item-spacing-horizontal),
77+
#efeff4 100%
78+
) !important;
79+
border-top: none !important;
80+
border-bottom: none !important;
81+
position: relative;
82+
z-index: 1;
83+
padding-left: calc(var(--sidebar-search-icon-size) + var(--sidebar-item-spacing-horizontal) * 2) !important;
84+
}
85+
/* Restore the search icon (matches Furo default) */
86+
.sidebar-search-container::before {
87+
content: "";
88+
position: absolute;
89+
top: 50%;
90+
left: var(--sidebar-item-spacing-horizontal);
91+
width: var(--sidebar-search-icon-size);
92+
height: var(--sidebar-search-icon-size);
93+
display: block;
94+
transform: translateY(-50%);
95+
background-color: var(--color-sidebar-search-icon) !important;
96+
z-index: 5;
97+
mask-image: var(--icon-search);
98+
-webkit-mask-image: var(--icon-search);
99+
mask-repeat: no-repeat;
100+
-webkit-mask-repeat: no-repeat;
101+
mask-position: center;
102+
-webkit-mask-position: center;
103+
pointer-events: none;
104+
}
105+
106+
/* Left menu active/highlighted page */
107+
:root {
108+
--color-sidebar-item-background--current: #fbca89;
109+
}
110+
.sidebar-tree .current > .reference,
111+
.sidebar-tree .current-page > .reference {
112+
background: linear-gradient(
113+
90deg,
114+
rgba(251, 202, 137, 0) 0%,
115+
#fbca89 var(--sidebar-item-spacing-horizontal),
116+
#fbca89 100%
117+
) !important;
118+
}
119+
120+
/* Override base background (left gutter) while keeping content white */
121+
html,
122+
body {
123+
background: #ffdfb4 !important;
124+
}
125+
.page {
126+
background: #ffdfb4 !important; /* ensure outer layout uses the gutter color */
127+
}
128+
.main,
129+
.main-content,
130+
.content,
131+
.article {
132+
background: #ffffff !important; /* keep center content area white */
133+
}

build/.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 935914a60f8c8c2291e50a58c66bc48f
3+
config: 18f0f6d15f8fe781a14a84e8cb0397cc
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

build/.buildinfo.bak

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Sphinx build info version 1
2+
# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
3+
config: b66cfdc9d94f3475b7b891ac0a6eab11
4+
tags: 645f666f9bcd5a90fca523b33c5a78b7

build/.doctrees/environment.pickle

138 Bytes
Binary file not shown.
-2.65 KB
Binary file not shown.

build/_sources/introduction.md.txt

Lines changed: 30 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,32 +2,36 @@
22

33
## Why teach Object Orientated Programming?
44

5-
Introducing your students to Object Orientated Programming (OOP) opens them to a world of possibilities.
5+
Introducing students to Object-Oriented Programming (OOP) sets them up with skills that underpin modern software development.
66

7-
Object Orientated Programming is one of the major programming paradigms currently in use. In learning how to use OOP students will learn good programming practice. They will learn to produce code that is more efficient, secure, maintainable, and extendable.
7+
OOP is a core programming paradigm used across industry. Teaching it early helps students write code that is cleaner, more secure, easier to maintain, and simpler to extend.
88

9-
This is especially important for Python. Although Python can implement a functional paradigm, it is essentially a Object Orientated language (everything in Python is an object). Many Python modules and easily available resources assume the reader is familiar with OOP. Once your students have a solid understanding of OOP, they can extend their Python skills by accessing the resources provided by the Python community.
9+
This matters in Python. While Python supports functional styles, it is fundamentally object-oriented. Most Python libraries and community resources assume readers understand classes, objects, and methods. Once students grasp OOP, they can make full use of the wider Python ecosystem.
1010

11-
Finally, starting your students on OOP will make it easier for them later in their coding career. If your students study programming at ta tertiary level, they will need to learn to code in OOP. The longer their introduction to OOP is postponed, the hard it is for them to accommodate the new programming paradigm (this I know from my own experience).
11+
Upper secondary Digital Technologies subjects are also increasingly expecting students to apply OOP in their solutions, making early exposure even more important.
12+
13+
A strong grounding in OOP prepares students for future study. Tertiary programming courses expect students to work with object-oriented design from day one, and delaying exposure only makes that transition harder.
1214

1315
## Why this site?
1416

15-
I created this site for use with my secondary school students. It is inspired by some of the courses that finally taught me how to code using OOP.
17+
This site was developed for use with secondary Digital Technologies students and is based on the resources that finally helped me learn to code effectively with OOP.
18+
19+
It supports my classroom practice by addressing two common issues:
1620

17-
This site supports my classroom practice by addressing two issues:
21+
* students arrive with very different levels of coding experience
22+
* extended student absences, particularly during the COVID-19 period
1823

19-
- the divergence of my students' coding experience entering into this introductory unit
20-
- regular and extended absences during the Covid 19 pandemic
24+
My teaching approach is:
2125

22-
My pedagogical approach is thus:
26+
* Students access the website and work through the material at their own pace.
2327

24-
- Students are presented with the website and are invited to proceed at their own pace.
25-
- This allows students to race ahead if they wish.
26-
- I have included a page with extension challenges, for those students who finish before the class.
27-
- I live code the content with the class.
28-
- This represents the minimum progress I expect from students
29-
- If they are behind what I am doing in class, they need to use this website to catch up.
30-
- If students fall behind, they can catch up via this site.
28+
* Students who move quickly can progress ahead.
29+
* An extension page is provided for those who finish early.
30+
* I live-code each section with the class.
31+
32+
* This sets the minimum expected progress.
33+
* Students who fall behind what is covered in class must use the website to catch up.
34+
* Any student who misses lessons or needs extra time can use this site to get back on track.
3135

3236
```{admonition} Corrections
3337
:class: important
@@ -45,17 +49,16 @@ The videos linked from this site where created prior to developing this site. Al
4549

4650
### Australian Curriculum
4751

48-
The content of this website can be used to address the following content descriptors of the Australian
49-
Curriculum - Digital Technologies. The intention is to add both flowchart and pseudocode to this course to more fully meet the requirements of the Australian Curriculum.
50-
51-
| Level | Australian Curriculum v8.4 | Australian Curriculum v9 |
52-
| :--- | :--- | :--- |
53-
| Years 7 and 8 | [ACTDIP029](https://www.australiancurriculum.edu.au/Search/?q=ACTDIP029) | [AC9TDI8P05](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P05&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
54-
| | [ACTDIP030](https://www.australiancurriculum.edu.au/Search/?q=ACTDIP030) | [AC9TDI8P06](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P06&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
55-
| | | [AC9TDI8P09](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P09&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
56-
| Years 9 and 10 | [ACTDIP040](https://www.australiancurriculum.edu.au/Search/?q=ACTDIP040) | [AC9TDI10P05](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P05&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
57-
| | [ACTDIP041](https://www.australiancurriculum.edu.au/Search/?q=ACTDIP041) | [AC9TDI10P06](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P06&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
58-
| | | [AC9TDI10P08](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P08&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
52+
The content of this website can be used to address the following content descriptors of the Australian Curriculum - Digital Technologies. The intention is to add both flowchart and pseudocode to this course to more fully meet the requirements of the Australian Curriculum.
53+
54+
| Level | Australian Curriculum v9 |
55+
| :--- | :--- |
56+
| Years 7 and 8 | [AC9TDI8P05](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P05&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
57+
| | [AC9TDI8P06](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P06&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
58+
| | [AC9TDI8P09](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY78&content-description-code=AC9TDI8P09&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
59+
| Years 9 and 10 | [AC9TDI10P05](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P05&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
60+
| | [AC9TDI10P06](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P06&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
61+
| | [AC9TDI10P08](https://v9.australiancurriculum.edu.au/f-10-curriculum/learning-areas/digital-technologies/year-7_year-8_year-9_year-10/content-description?subject-identifier=TECTDIY910&content-description-code=AC9TDI10P08&detailed-content-descriptions=0&hide-ccp=0&hide-gc=0&side-by-side=1&strands-start-index=0&subjects-start-index=0&view=quick) |
5962

6063

6164
### Website Blocked

build/_static/custom.css

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
/* Match admonition text to regular body size */
2+
.admonition,
3+
.admonition p,
4+
.admonition .admonition-title {
5+
font-size: inherit;
6+
}
7+
/* Increase specificity so it overrides the theme defaults */
8+
.admonition > .admonition-title {
9+
font-size: inherit !important;
10+
font-weight: 700 !important;
11+
}
12+
/* Ensure nested admonition titles also pick up weight */
13+
.admonition .admonition-title {
14+
font-weight: 700 !important;
15+
}
16+
17+
/* Make topic directive text match body size */
18+
.topic,
19+
.topic p,
20+
.topic .topic-title {
21+
font-size: inherit;
22+
}
23+
/* Increase specificity to override theme defaults */
24+
.topic > .topic-title {
25+
font-size: inherit !important;
26+
font-weight: 700;
27+
}
28+
29+
/* Make code blocks match body font size */
30+
pre,
31+
.highlight pre,
32+
.literal-block {
33+
font-size: inherit;
34+
}
35+
36+
/* Make inline code match body font size */
37+
code,
38+
.docutils.literal {
39+
font-size: inherit;
40+
}
41+
42+
/* Heading color tweaks */
43+
h1 {
44+
color: #ff9100 !important;
45+
}
46+
h2 {
47+
color: #ffab3c !important;
48+
}
49+
h3 {
50+
color: #ffba5f !important;
51+
}
52+
h4 {
53+
color: #fbca89 !important;
54+
}
55+
56+
/* Sidebar background (covers gutter left of nav) */
57+
.sidebar-drawer,
58+
.sidebar,
59+
.sidebar-container,
60+
.sidebar-scroll {
61+
background: #ffdfb4 !important;
62+
}
63+
.sidebar-search-container {
64+
position: relative !important;
65+
background: linear-gradient(
66+
90deg,
67+
rgba(251, 202, 137, 0) 0%,
68+
#fbca89 var(--sidebar-item-spacing-horizontal),
69+
#fbca89 100%
70+
) !important;
71+
}
72+
.sidebar-search {
73+
background: linear-gradient(
74+
90deg,
75+
rgba(239, 239, 244, 0) 0%,
76+
#efeff4 var(--sidebar-item-spacing-horizontal),
77+
#efeff4 100%
78+
) !important;
79+
border-top: none !important;
80+
border-bottom: none !important;
81+
position: relative;
82+
z-index: 1;
83+
padding-left: calc(var(--sidebar-search-icon-size) + var(--sidebar-item-spacing-horizontal) * 2) !important;
84+
}
85+
/* Restore the search icon (matches Furo default) */
86+
.sidebar-search-container::before {
87+
content: "";
88+
position: absolute;
89+
top: 50%;
90+
left: var(--sidebar-item-spacing-horizontal);
91+
width: var(--sidebar-search-icon-size);
92+
height: var(--sidebar-search-icon-size);
93+
display: block;
94+
transform: translateY(-50%);
95+
background-color: var(--color-sidebar-search-icon) !important;
96+
z-index: 5;
97+
mask-image: var(--icon-search);
98+
-webkit-mask-image: var(--icon-search);
99+
mask-repeat: no-repeat;
100+
-webkit-mask-repeat: no-repeat;
101+
mask-position: center;
102+
-webkit-mask-position: center;
103+
pointer-events: none;
104+
}
105+
106+
/* Left menu active/highlighted page */
107+
:root {
108+
--color-sidebar-item-background--current: #fbca89;
109+
}
110+
.sidebar-tree .current > .reference,
111+
.sidebar-tree .current-page > .reference {
112+
background: linear-gradient(
113+
90deg,
114+
rgba(251, 202, 137, 0) 0%,
115+
#fbca89 var(--sidebar-item-spacing-horizontal),
116+
#fbca89 100%
117+
) !important;
118+
}
119+
120+
/* Override base background (left gutter) while keeping content white */
121+
html,
122+
body {
123+
background: #ffdfb4 !important;
124+
}
125+
.page {
126+
background: #ffdfb4 !important; /* ensure outer layout uses the gutter color */
127+
}
128+
.main,
129+
.main-content,
130+
.content,
131+
.article {
132+
background: #ffffff !important; /* keep center content area white */
133+
}

build/admonitions.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
1313
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
1414
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
15+
<link rel="stylesheet" type="text/css" href="_static/custom.css?v=4abda5ee" />
1516

1617

1718

build/debugging.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
1313
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
1414
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
15+
<link rel="stylesheet" type="text/css" href="_static/custom.css?v=4abda5ee" />
1516

1617

1718

build/ext_player.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@
1212
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
1313
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
1414
<link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
15+
<link rel="stylesheet" type="text/css" href="_static/custom.css?v=4abda5ee" />
1516

1617

1718

0 commit comments

Comments
 (0)