Skip to content

Rhaptos Software Development

Personal tools
You are here: Home » Documentation » Training » RSW's training course notes

RSW's training course notes

Document Actions
Course notes for 2-day CNX training course (based on richb's 1-day course).

*************************************************************************** Session 1: CNX General Introduction

1) go to main page (cnx.org), show/explain tabs

2) show login box, but don't log in

3) go to content tab, browse through subjects (point out ~4k small modules, ~200 collections)

4) search in content for "music theory", "digital signal processing"

5) show what module looks like - good examples is "Half Steps and Whole Steps" (m10866). use to segue to basic/advanced CNXML markups.

6) talk about CNXML markup language, emphasize that information encoded to reflect semantics. discuss basic CNXML (m14394): emphasis, term, note, CNXN, link, cite, quote, foreign, code. discuss advanced CNXML (m14395): para, list, equation, exercise, figure, table, note, example.

7) show math support - e.g. complex fourier series module (m10784). mention how it's content MathML, so encodes what means, not what looks like. can cut-and-paste into Mathematica or similar tool. show how mathML scales well as text size increases (ctrl+ in firefox).

8) show multi-lingual capability using spanish version of previous (m12848)

9) show use of multimedia content (e.g., m12660). possible multimedia objects include Images, Flash objects, Movies, Java applets, Audio files, LabVIEW demonstrations (e.g., m10085, m13115)

10) show the open license, explain its provisions, point how how attribution lets you track content's impact, show lawyer-readable version

11) show meta-data, talk about how maintainers help authors, talk about version history

12) talk about how can easily generate printed version. show how .pdf actually looks good (vs. printing web page). show how links, cnxns appear as footnotes at bottom of document. NOTE: pre-launch acrobat reader to make go faster.

13) talk about non-linear organization through cnxns, show how modules can be combined to form courses (e.g., "Understanding Basic Music Theory" - col10363, "CNXML Tutorial" - col10121 ). show navigation bar roadmap for courses.

14) talk about ultimate goal of course printing. go to don johnson's course (col10040) and show "order printed copy" button.

15) show author profile pages (e.g., rich's page), say in future will show module hit stats -> way to measure impact

16) search for leadership module (m13813) and talk about lenses, endorsements. click on NCPEA endorsement and show page.

17) show RUSP page (col10376), mention how uses CNX as digital backend

*************************************************************************** Session 2: CNX Author Tools Introduction

1) log in, have students log in. show personal workspace (only author adds, modifies). show collaborative workgroups (all authors in workgroup add, modify).

2) author workspace: can create a new course or module or add a new file/image for storage for later. can also search for existing content and add to your workspace.

3) EXAMPLE: creating a new module. a) go through licensing, MathML inclusing, metadata entry. b) discuss editing choices, saying there are 3 steps of removal: MS Word editor, edit-in-place, CNXML source editor. c) say preferred path is MS Word. distribute pre-fab MS Word document and have students upload. d) discuss print, online preview options. caution about publish option. e) have students look at resulting upload in edit-in place interface. have them look at raw source interface. f) have students click on various edit-in-place items to see how they isolate content from tag data. show how each tag suggests usage and has links to valid children. g) have students modify upload through edit-in-place by adding a caption to the figure.

f) have students modify by adding a paragraph with a link. g) talk about how changes made in edit-in-place will be un-done by new word import. thus, all editing must be done in edit-in-place after initial import.

NOTE: best reference for CNXML tag usage is "Tutorial" on Help page (http://cnx.org/content/col10151/latest/). For more detail, can go to to "CNXML Language" on Help page (http://cnx.org/technology/cnxml/0.5/spec/).

4) EXAMPLE: creating a new course. a) go through licensing, metadata entry. b) create a "music section". search "music theory" and pick a few modules to add. c) show how modules in section can be ordered with "top","up","down","bottom" arrows. d) go up one level, create a "DSP section". e) go to DSP Section, search "signal processing", and add a few modules.

3) EXAMPLE: adding existing module. a) search "half steps", add to workspace. b) click on added module and show how you can (1) make changes and suggest the edit, (2) make changes and create a derived copy. c) create a derived copy and show my name in the new roles.

4) EXAMPLE: adding existing course. a) search for and add "signals and systems" course. b) modify by removing last module. c) create derived copy. show my name in new roles.

*************************************************************************** Session 3: MS Word Importer practice

1) point students to handout, original module source (http://cnx.org/content/m13056/latest/).

2) have them download MS Word template (http://cnx.rice.edu/help/Connexions-Document.dot) and install per into Word per instructions.

3) have them open template and go through how to create sections, subsections, and use included CNXML styles to mark up documents. add hyperlinks and add an image. maybe add some math. have them import.

4) go through instructions on how to install CNXML styles to an existing document and mark it up. caution about proper math entry style.

********************************************************************* COMMENTS: seems to work pretty well, takes up most of two days. probably want to add instructions for creating/managing workgroups.

Created by rwagner
Last modified 2007-10-18 15:14