Sample pico markdown page
This is a sample SCS themed pico page. Pico is a flat-file content management system for your personal web page.
Installing Pico CMS
Pre-requisites:
- you need an SCS Linux account
- download the SCS Pico installation
- Good to have: SCS Nextcloud
Once you download the pico installation untar it in your linux home directory. Replace your public_html with the pico files and you are now serving files using pico.
SCS Nextcloud can be configured to link to your SCS Linux account. Then it is simple to copy and edit files in your SCS Linux home directory in particular your SCS home page (public_html). Click on the markdown files within Nextcloud will launch the markdown editor.
Getting Started
You can create website pages using the entuitive and simple markdown format. Note that simple html will also work.
All markdown pages are placed in the content folder under your pico instalation. Markdown pages end with the .md extension.
Once you have pico installed you can create markdown pages:
- log into nextcloud using your web browser
- find your Linux account folder and find public_html/pico/content
- create a new file with with the .md extension, let's call it hello_world.md
- click on the file. This will launch the inline markdown editor. Add content. Saving is done automatically.
- reference your page
https://www.scs.carleton.ca/~your_username/pico/hello_world
SCS Theme
The SCS theme is a simple responsive pico template.
You can set your name by editing this file:
pico/themes/default/name.html
You can chnage the themes top header links here:
pico/themes/default/menubar.html
Pico Template
The pico template can be found here:
pico/themes/default/index.twig
twig is a php template engine.
PHP
SCS PHP settings:
Create a new folder under pico and place for php files there.
Linking to pages
To link to a page that you have created use this format:
https://www.scs.carleton.ca/~your_username/pico/hello_world
and your markdown file would be called hello_world.md and is linked as follows:
Images
Images must be placed in the assets folder and can be referenced using environment variable:
%base_url%/assets/<image_name>
Markdown syntax examples
Headers
# H1
## H2
### H3
#### H4
##### H5
###### H6
Code block
Use 2 sets of 4 x tilda chars to contain codeblocks: ~~~~
Rendered look:
Device 0: "GeForce GTX 1080 Ti"
CUDA Driver Version / Runtime Version 10.0 / 10.0
CUDA Capability Major/Minor version number: 6.1
Total amount of global memory: 11178 MBytes (11721506816 bytes)
(28) Multiprocessors, (128) CUDA Cores/MP: 3584 CUDA Cores
GPU Max Clock rate: 1582 MHz (1.58 GHz)
Memory Clock rate: 5505 Mhz
Memory Bus Width: 352-bit
Colons can be used to align columns.
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
There must be at least 3 dashes separating each header cell. The outer pipes (|) are optional, and you don't need to make the raw Markdown line up prettily. You can also use inline Markdown.
Markdown | Less | Pretty |
---|---|---|
Still | renders |
nicely |
1 | 2 | 3 |
Blockquotes are very handy in email to emulate reply text. This line is part of the same quote.
Quote break.
This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can put Markdown into a blockquote.