-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathFINISH
90 lines (86 loc) · 4.05 KB
/
FINISH
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# learning_step
# unit: discourse_theme_development.1
# number: 17
# title: How to configure a theme
# description: The last thing we're going to look at in this introduction are
# the two theme configuration files: ``about.json`` and
# ``settings.yml``. We'll go through each briefly now and return
# to go through them in more depth later in the course.
# references: https://meta.discourse.org/t/60848
# /learning_step
# learning_step
# unit: discourse_theme_development.1
# number: 18
# title: How to configure the about.json file
# description: The ``about.json`` file's primary role is to set metadata about
# a theme. Have a look at the meta.discourse.org topic in the
# references for a list of metadata you can add. The ``about.json``
# can also be used to configure assets and colour schemes.
#
# To see how the ``about.json`` works, add your name to the
# "authors" value. The convention is to seperate each name by a
# comma followed by a space. Then go to the "My Themes" panel in
# the Theme Creator, click on "Discourse Theme Introduction" and
# refresh the page. You should now see your name included in the
# "Authors" metadata.
#
# Experiment with the other metadata, but don't worry about them
# too much for now. We'll be covering different parts of this file
# in more depth later in the course.
# references: https://meta.discourse.org/t/119205
# /learning_step
# learning_step
# unit: discourse_theme_development.1
# number: 19
# review: peer
# mark: pass_change_fail
# title: How to use the settings.yml file
# description: The ``settings.yml`` file is where you add settings you can
# change in the theme administration interface. The main point of
# this is to make it easy to configure the theme without changing
# the code.
#
# Settings are useful when you're developing an open source theme
# that people will use on different forums, and you want to let
# them make some changes to suit their forum.
#
# Settings are also useful when you're making a theme that will be
# administered by a non-technical forum administrator and you want
# to let them configure how the theme looks or works themselves.
#
# We'll be going into settings in more depth in a later unit, but
# for now, let's see a simple setting in action. Open the
# ``settings.yml`` file and paste in this line
#
# ```
# body_background_img_url: https://pavilion-assets.nyc3.digitaloceanspaces.com/education/pattern.png
# ```
#
# Save the file, then go back to Discourse Theme Introduction in
# your "My Themes" list on the Theme Creator. Scroll down to the
# bottom and you'll now see a section called "Theme Settings" with
# the setting we just added.
#
# To use the setting, go to the ``common/common.scss`` file and
# change the ``body`` ``background`` to
#
# ```
# url("#{$body_background_img_url}");
# ```
#
# Then open up your preview tab, and you'll now see a repeated
# background pattern image. Experiment by changing the setting to
# a different online image url.
#
# exercise: Post a comment with evidence of a successful background change
# using a setting.
# references: https://meta.discourse.org/t/82557
# /learning_step
# learning_step
# unit: discourse_theme_development.1
# number: 20
# visibility: hidden:until_previous_completed
# title: Unit Video
# description: This is where video of a teacher completing the unit goes when
# you're taking the unit on [Pavilion Education](https://education.thepavilion.io).
# /learning_step