README.md 2.07 KB
Newer Older
Mike Lake's avatar
Mike Lake committed
1
# Singularity Talk
Mike Lake's avatar
Mike Lake committed
2

Mike Lake's avatar
Mike Lake committed
3
This contains slides for a short talk on singularity. 
Mike Lake's avatar
Updated    
Mike Lake committed
4
5
See also the tutorial for HPC users at 
<https://hpc.research.uts.edu.au/software_general/singularity/> 
Mike Lake's avatar
small    
Mike Lake committed
6

Mike Lake's avatar
Mike Lake committed
7
8
## Files

Mike Lake's avatar
Mike Lake committed
9
  - singularity_slides.html - The HTML tutorial as "Reveal" slides. I'm using Markdown within the slides.
Mike Lake's avatar
Updated    
Mike Lake committed
10
  - singularity_slides.css  - CSS to overide `reveal.js/css/` styles.
Mike Lake's avatar
Mike Lake committed
11
  - centos7.def             - An example Singularity recipe 
Mike Lake's avatar
Mike Lake committed
12
13
14
15

## Reveal.js Framework 

I am using the reveal.js HTML presentation framework, a demo of which can be seen at 
Mike Lake's avatar
Updated    
Mike Lake committed
16
its homepage <https://revealjs.com>.
Mike Lake's avatar
Mike Lake committed
17
18
19
20
21
To use this you need to clone its GIT repo into a local directory as its not
included in this repo. Be in the same directory as this README.md and do:

    $ git clone https://github.com/hakimel/reveal.js.git
    
Mike Lake's avatar
Updated    
Mike Lake committed
22
23
This will have created the directory `reveal.js`. The links in the `singularity_slides.html` 
file reference files in this directory.  
Mike Lake's avatar
Mike Lake committed
24

Mike Lake's avatar
minor    
Mike Lake committed
25
## Creating a PDF of these Slides
Mike Lake's avatar
small    
Mike Lake committed
26

Mike Lake's avatar
Mike Lake committed
27
28
Does not work well:

Mike Lake's avatar
minor    
Mike Lake committed
29
30
31
32
33
The Javascript library `decktape` needs to be installed first. See below. 
After that just make sure your in the `singularity_talk` directory and do this:

    $ `npm bin`/decktape reveal http://localhost/~mlake/singularity_talk/singularity_slides.html test.pdf

Mike Lake's avatar
Mike Lake committed
34
35
36
37
38
39
40
This works OK:

Use Google Chrome!
Go to: http://localhost/~mlake/singularity_talk/singularity_slides.html?print-pdf
Use Print / Save


Mike Lake's avatar
minor    
Mike Lake committed
41
42
43
44
45
## Install Required Javascript Libs

Install node.js

    $ cd reveal.js
Mike Lake's avatar
small    
Mike Lake committed
46
    reveal.js/$ npm install
Mike Lake's avatar
Mike Lake committed
47
48
49
50
    Downloading binary from https://github.com/sass/node-sass/releases/download/v4.7.2/linux-x64-48_binding.node
    Caching binary to /home/mlake/.npm/node-sass/4.7.2/linux-x64-48_binding.node
    ....

Mike Lake's avatar
minor    
Mike Lake committed
51
Install decktape for Creating PDFs:
Mike Lake's avatar
Mike Lake committed
52

Mike Lake's avatar
minor    
Mike Lake committed
53
54
    singularity_talk/$ npm install decktape
    singularity_talk/$ `npm bin`/decktape
Mike Lake's avatar
Mike Lake committed
55

Mike Lake's avatar
minor    
Mike Lake committed
56
Install highlight.js for syntax highlighting:
Mike Lake's avatar
Mike Lake committed
57

Mike Lake's avatar
minor    
Mike Lake committed
58
    singularity_talk/$ npm install highlight.js
Mike Lake's avatar
Mike Lake committed
59

Mike Lake's avatar
Mike Lake committed
60
61
62
Didn't use this image.  
https://www.maxpixel.net/Universe-Cosmos-Black-Hole-Singularity-Space-3490482
The pictures on Max Pixel be freely distributed with a Creative Commons Zero - CC0.
Mike Lake's avatar
small    
Mike Lake committed
63

Mike Lake's avatar
Mike Lake committed
64
Mike Lake  
Mike Lake's avatar
Mike Lake committed
65
October 2018
Mike Lake's avatar
Mike Lake committed
66