discourse-theme-javascript-one/START at main · pavilionedu/discourse-theme-javascript-one · GitHub

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
# learning_course
# key:         discourse_theme_development
# /learning_course

# learning_unit
# course:       discourse_theme_development
# number:       6
# title:        Working with Javascript (Part 1)
# description:  This is the first of three units about working with Javascript in
#               Discourse themes. This is the sixth unit in the Discourse Theme
#               Development course. When you're ready to start, clone this unit
#               theme and start watching it on the [Discourse Theme Creator](https://theme-creator.discourse.org).
# references:   https://github.com/pavilionedu/discourse-theme-javascript-one
#               https://meta.discourse.org/t/110448
# /learning_unit

# learning_step
# unit:         discourse_theme_development.6
# number:       1
# title:        When do you work with Javascript?
# description:  There are a few reasons why you'd be working with javascript in
#               a Discourse theme. We'll cover the first reason in this unit,
#               and the other two in the following units.
#
#               Firstly, you may be adding some embedded functionality where the
#               Javascript is loaded from an external source, and just needs to
#               be linked and loaded correctly, or requires some minor local
#               scripting. For an example of this, have a look at at the
#               Intercom Widget theme components. This is typically the easiest
#               scripting you'll do as it doesn't require you to understand how
#               Discourse javascript is structured.
#
#               Secondly, you may be modifying or extending some existing
#               functionality in Discourse. You may want to change the way the
#               "New Topic" button behaves for example. Check out the Expanded
#               Create Topic component for an example of this. This kind of work
#               requires you to understand a bit about how the Discourse
#               javascript works and will involve the Discourse client-side
#               javascript api.
#
#               Lastly, you may want to add your own entirely new functionality
#               within Discourse. The complexity of this can range significantly
#               from something relatively simple like the Category Banners
#               component, to something complex like the Kanban Theme Component.
#               We'll cover this last.
#
#               In many cases you'll be using multiple approaches at once, i.e.
#               embedding, extending and adding, however we're going to be
#               addressing each in turn through example cases to illustrate
#               some of the specific issues you might face in each case.
#
# next_step:    head_tag.html
# references:   https://github.com/discourse/discourse-intercom-widget
#               https://github.com/jordanvidrine/discourse-expanded-create-topic
#               https://github.com/discourse/discourse-category-banners
#               https://github.com/discourse/discourse-kanban-theme
# /learning_step