Skip to content

Turns plain text files into HTML, specifically designed for webpages within Moodle

Notifications You must be signed in to change notification settings

gsinclair/moodle_markup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

moodle_markup.rb

A library for turning text files into HTML suitable for placing on Moodle.

Designed for use by the PLC Sydney Mathematics Department, and not likely to be useful to anyone else! The general idea may be of interest, though.

Example input file:

[Topic 16]

[Description]

Coordinate geometry is a large topic. The programme is divided into three parts:
 * 16a: distance, midpoint, gradient diagrams; number plane graphs
 * 16b: distance, midpoint, gradient formulas; y = mx + b
 * 16c: further equations of a line; regions

Note: there is a lot of detail in the "y = mx + b" area: sketching; finding
equations; parallel and perpendicular lines; general form; and more.

{highlight:Only 16a and 16b were assessed in Task 2 on 17 March 2010.}

[Resources]

<Coordinate geometry skills worksheet> 5.23 F file:^A030.+worksheet.pdf
  A summary of (nearly?) all the skills taught in this topic.
  {file:Solutions|16|A030.*SOLUTIONS.pdf}

<Further equations of straight lines> 5.3 F,PS file:^Further.+lines.pdf
  Textbook exercise with more challenging questions on finding the equations of
  straight lines.

<Graphing straight line families> 5.123 U file:^Graphing
  A GSP file encouraging you to think about the relationship between a linear
  equation and the corresponding graph. Essentially a teaching resource, but
  useful for independent study. {warn:Only works if you have Geometers Sketchpad
  installed.}

<Gradient product of perpendicular lines> 5.2 U file:^A019 Gradient.+.gsp$
  Explore the relationship between the gradients of two lines when they become
  perpendicular. {warn:Only works if you have Geometers Sketchpad installed.}

[Websites]

<Linear graph animation> 5.1 F
  url:http://example.com
  Take the challenge to determine an equation from its graph, and vice versa.

[Note]

{red:U} = Understanding; {red:F} = Fluency; {red:PS} = Problem Solving

The output contains links to the appropriate files, replaces things like {warn:Only works if...} with appropriately-styled HTML, contains images representing level of difficulty (5.1, 5.2, 5.3), and more.

Errors are reported if anything in the input is not as it should be:

  • invalid level or category codes like “5.4” or “U,M”

  • invalid section title like “[See Also]”

  • resource or website info line not correctly formatted

Background

I create webpages in Moodle as part of my job. Certain aspects of doing this are extremely annoying. This project allows me to turn plain text files (with certain layout and formatting rules observed) into HTML that I can copy into Moodle (or insert directly into the database).

Contact

gsinclair at gmail dot com

About

Turns plain text files into HTML, specifically designed for webpages within Moodle

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published