Git Product home page Git Product logo

curriculum-parser's Introduction

@laboratoria/curriculum-parser

Command line tool used to parse content written in markdown for our LMS at @Laboratoria (See Laboratoria/bootcamp).

Build Status Coverage Status

Installation

Install as a development dependency in your project:

npm i --save-dev @laboratoria/curriculum-parser

You should now be able to run it with npx:

npx curriculum-parser # when already installed in project

# or alternatively using full package name (with org)
# this works even if nor previously installed.
npx @laboratoria/curriculum-parser

You can also install curriculum-parser globally using npm like this:

npm i -g @laboratoria/curriculum-parser

If you get a permission error please try using sudo (you may need admin permissions depending on your node installation).

# using `sudo` (only if previous step failed)
sudo npm i -g @laboratoria/curriculum-parser

Alternatively you can install using a local clone.

# clone from your own fork
git clone [email protected]:<your-username>/curriculum-parser.git
cd curriculum-parser
npm install
npm link

If the above command fails, try using sudo:

sudo npm link

Upgrade

If you installed globally using npm you can simply re-install like so:

npm i -g @laboratoria/curriculum-parser

If you chose to install using a local clone, you can update your clone to upstream master:

# go into local copy of repo
cd curriculum-parser
# if not yet added a reference to upstream remote we add it
git remote add upstream [email protected]:Laboratoria/curriculum-parser.git
# fetch changes and merge upstream/master into local master
git fetch upstream
git merge upstream/master
# you may also want to push changes to your fork
git push origin master

Usage

After installing globally (or linking with npm link) you should have the curriculum-parser command available in your PATH.


Usage: curriculum-parser [command] [options]

Commands:

  help
  topic <dir> --repo --version --locale --track [--suffix]
  project <dir> --repo --version --locale --track --rubric [--suffix]

Global options:

  -h, --help        Show help
  -V                Show version

Examples

Parse a topic (course) within the Laboratoria/bootcamp repo

curriculum-parser topic topics/javascript \
  --repo Laboratoria/bootcamp \
  --version 2.5.0 \
  --locale es-ES \
  --track js \
  > "build/topics/javascript.json"

Parse a portuguese topic (course) within the Laboratoria/bootcamp repo

curriculum-parser topic topics/javascript \
  --repo Laboratoria/bootcamp \
  --version 2.5.0 \
  --locale pt-BR \
  --track js \
  --suffix pt \
  > "build/topics/javascript-pt.json"

Parse a project within the Laboratoria/bootcamp repo

curriculum-parser project projects/01-cipher \
  --repo Laboratoria/bootcamp \
  --version 2.5.0 \
  --locale es-ES \
  --track js \
  --rubric 2.x \
  > "build/projects/01-cipher.json"

Parse a portuguese project within the Laboratoria/bootcamp repo

curriculum-parser project projects/01-cipher \
  --repo Laboratoria/bootcamp \
  --version 2.5.0 \
  --locale pt-BR \
  --track js \
  --rubric 2.x \
  --suffix pt \
  > "build/projects/01-cipher-pt.json"

Parse a topic (course) in the curricula-ux repo

curriculum-parser topic 00-topics/00-intro-ux \
  --repo Laboratoria/curricula-ux \
  --version 1.0.0 \
  --track ux \
  --locale es-ES

Parse a topic (course) in some arbitrary directory

curriculum-parser topic . \
  --repo some-github-user/some-github-repo \
  --path . \
  --version 1.0.0 \
  --track business \
  --locale es-ES

curriculum-parser's People

Contributors

lupomontero avatar maiarojas avatar ivandevp avatar arku avatar cemsbr avatar rafaelbcerri avatar

Watchers

James Cloos avatar Fabian Alexis Bravo Abarca avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.