Ok, so I am really excited to have found mermaid- the software. LOL.
I was looking for a tool that I can generate a chart. It started off with markdown and I ended up running
into mermaid.
mermaid is written in JavaScript, so you will need to have node.js installed on your lappy.
Come to think of it, I haven't write an article about node.js, yet. I will do it later. *giggle*
NOTE: I found out later that mermaid requires Phantom.js and not node.js. I need to rewrite this section. One thing for sure, all of these require npm. Yeah, more stuffs to write about...
Installing mermaid is pretty simple, but only if you have node installed. So if you don't have node go ahead and install it on your puter.
The following is a script of me installing mermaid on my beloved Macbook Pro.
[reia-mbp15:~] reia% sudo npm install -g mermaid Password: > contextify@0.1.13 install /usr/local/lib/node_modules/mermaid/node_modules/d3/node_modules/jsdom/node_modules/contextify > node-gyp rebuild gyp WARN EACCES user "root" does not have permission to access the dev dir "/Users/reia/.node-gyp/0.10.33" gyp WARN EACCES attempting to reinstall using temporary dev dir "/usr/local/lib/node_modules/mermaid/node_modules/d3/node_modules/jsdom/node_modules/contextify/.node-gyp" CXX(target) Release/obj.target/contextify/src/contextify.o SOLINK_MODULE(target) Release/contextify.node SOLINK_MODULE(target) Release/contextify.node: Finished /usr/local/bin/mermaid -> /usr/local/lib/node_modules/mermaid/bin/mermaid.js mermaid@0.4.0 /usr/local/lib/node_modules/mermaid ├── which@1.0.9 ├── minimist@1.1.1 ├── he@0.5.0 ├── semver@4.3.1 ├── mkdirp@0.5.0 (minimist@0.0.8) ├── moment@2.9.0 ├── chalk@0.5.1 (ansi-styles@1.1.0, escape-string-regexp@1.0.3, supports-color@0.2.0, has-ansi@0.1.0, strip-ansi@0.3.0) ├── dagre-d3@0.3.3 (graphlib@1.0.1, dagre@0.6.4, lodash@2.4.1) └── d3@3.4.13 (jsdom@1.0.0) [reia-mbp15:~] reia%
After the installation, I tried to run it but it failed.... *sad face*.
[reia-mbp15:~] reia% mermaid mermaid: Command not found.It turns out that I didn't have "/usr/local/bin" in my PATH, silly me. LOL.
[reia-mbp15:~] reia% /usr/local/bin/mermaid You had errors in your syntax. Use --help for further information. You must specify at least one source file. Cannot find phantomjs in your PATH. If phantomjs is installed you may need to specify its path manually with the '-e' option. Run this executable with '--help' or view the README for more details. [reia-mbp15:~] reia% /usr/local/bin/mermaid --help Usage: mermaid [options]... file The mermaid description file to be rendered Options: -s --svg Output SVG instead of PNG (experimental) -p --png If SVG was selected, and you also want PNG, set this flag -o --outputDir Directory to save files, will be created automatically, defaults to `cwd` -e --phantomPath Specify the path to the phantomjs executable -t --css Specify the path to a CSS file to be included when processing output -c --sequenceConfig Specify the path to the file with the configuration to be applied in the sequence diagram -h --help Show this message -v --verbose Show logging --version Print version and quit [reia-mbp15:~] reia%
you can find a lot of example of mermaid at http://knsv.github.io/mermaid/.
Here's just a short one:
sequenceDiagram
Customer ->> HelpDesk: Case Open
Note right of HelpDesk: SR open via CRM
if there is no known PR
Then HelpDesk open a new PR
HelpDesk->> ACE: Create a new PR
Note right of ACE: Update the PR
and change PR status to
"info"
% osascript scriptname.scpt
package command provides the ability to use a package, compare package versions, and to register your own packages with an interpreter. A package is loaded by using the package require command and providing the package name and optionally a version number. The first time a script requires a package Tcl builds up a database of available packages and versions. It does this by searching for package index files in all of the directories listed in the tcl_pkgPath and auto_path global variables, as well as any subdirectories of those directories. Each package provides a file called pkgIndex.tcl that tells Tcl the names and versions of any packages in that directory, and how to load them if they are needed.package require statements to load any packages required. This serves two purposes: making sure that any missing requirements are identified as soon as possible; and, clearly documenting the dependencies that your code has. Tcl and Tk are both made available as packages and it is a good idea to explicitly require them in your scripts even if they are already loaded as this makes your scripts more portable and documents the version requirements of your script.sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 sudo ./adb
sudo pip install git+https://github.com/Juniper/ncclient.git sudo pip install junos-ezncMy first try was unsuccessful and I got the following messages:
Running setup.py egg_info for package lxml
/usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown distribution option: 'bugtrack_url'
warnings.warn(msg)
Building lxml version 3.3.0.
Building without Cython.
ERROR: /bin/sh: 1: xslt-config: not found
** make sure the development packages of libxml2 and libxslt are installed **
Not included in the instruction is that I also need to install two additional packages:
% sudo apt-get install python-dev % sudo apt-get install libxslt1-devAfter I install the two packages, the installation of the pyez was very smooth.
reia@ubuntu:~$ python
Python 2.7.3 (default, Sep 26 2013, 20:03:06)
[GCC 4.6.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> from pprint import pprint
>>> from jnpr.junos import Device
>>> dev = Device(host='mysun.example.net', user='me', password='more0fme')
>>> dev.open()
Device(mysun.example.net)
>>> pprint( dev.facts )
{'2RE': True,
'HOME': '/var/home/lab',
'RE0': {'last_reboot_reason': 'Router rebooted after a normal shutdown.',
'mastership_state': 'master',
'model': 'RE-S-1800x4',
'status': 'OK',
'up_time': '17 hours, 51 minutes, 36 seconds'},
'RE1': {'last_reboot_reason': 'Router rebooted after a normal shutdown.',
'mastership_state': 'backup',
'model': 'RE-S-1800x4',
'status': 'OK',
'up_time': '16 hours, 22 minutes, 55 seconds'},
'domain': None,
'fqdn': 'Sun-re0',
'hostname': 'Sun-re0',
'ifd_style': 'CLASSIC',
'master': 'RE0',
'model': 'MX480',
'personality': 'MX',
'serialnumber': 'JN1XXXXXXXXXX',
'switch_style': 'BRIDGE_DOMAIN',
'version': '12.3R5.7',
'version_RE0': '12.3R5.7',
'version_RE1': '12.3R5.7',
'version_info': junos.version_info(major=(12, 3), type=R, minor=5, build=7)}
>>>
And I notice that my router has been upgraded. That's it for now.