63 |
64 |
65 |
--------------------------------------------------------------------------------
/GHOST.txt:
--------------------------------------------------------------------------------
1 | Copyright (c) 2013-2017 Ghost Foundation - Released under The MIT License.
2 |
3 | Permission is hereby granted, free of charge, to any person
4 | obtaining a copy of this software and associated documentation
5 | files (the "Software"), to deal in the Software without
6 | restriction, including without limitation the rights to use,
7 | copy, modify, merge, publish, distribute, sublicense, and/or sell
8 | copies of the Software, and to permit persons to whom the
9 | Software is furnished to do so, subject to the following
10 | conditions:
11 |
12 | The above copyright notice and this permission notice shall be
13 | included in all copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
17 | OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
19 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
20 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 | OTHER DEALINGS IN THE SOFTWARE.
23 |
--------------------------------------------------------------------------------
/Gemfile:
--------------------------------------------------------------------------------
1 | source "https://rubygems.org"
2 |
3 | gem "jekyll", "~> 3.9.0"
4 | gem "github-pages", "~> 214"
5 | gem "rake", "~> 13.0.3"
6 | gem "slugify", "~> 1.0.7"
7 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2018-2021 Fábio Madeira
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | ## Jasper2
2 |
3 | [](https://github.com/jekyllt/jasper2/actions/workflows/jekyll_build.yml)
4 | [](http://travis-ci.org/jekyllt/jasper2)
5 | [](http://travis-ci.org/jekyllt/jasper2)
6 |
7 | This is a full-featured port of Ghost's default theme [Casper](https://github.com/tryghost/casper)
8 | [v2.1.9](https://github.com/TryGhost/Casper/releases/tag/2.1.9) for [Jekyll](https://jekyllrb.com/) / [GitHub Pages](https://pages.github.com/).
9 |
10 | ## Live Demo
11 |
12 | [Ghost's Casper](https://demo.ghost.io) // [Jasper2](https://jekyllt.github.io/jasper2)
13 |
14 | 
15 |
16 |
17 | ## Features
18 |
19 | * Out of the box support for multiple authors (via `_data/authors.yml`)
20 | * Full author information including: picture, bio, website, twitter, facebook, etc.
21 | * Tag description(s) and personalised covers (via `_data/tags.yml`)
22 | * Related posts view at the bottom of each post
23 | * All Ghost default pages: Author page(s), Tag page(s), About page(s), 404, etc.
24 | * Pagination (infinite scrolling or standard pagination, i.e. posts across multiple pages)
25 | * Atom Feeds by [Jekyll-feed](https://github.com/jekyll/jekyll-feed)
26 | * Toggleable subscribe button (requires an external service)
27 | * Code Syntax Highlight with [highlight.js](https://highlightjs.org/)
28 | * Support for Google Analytics tracking
29 | * Support for Disqus comments (not Ghost standard)
30 |
31 |
32 | ## Getting Started
33 |
34 | ### Deployment
35 |
36 | There are several alternatives to building and deploying the site:
37 |
38 | 1. build the site with [GitHub Actions](https://github.com/features/actions) which pushes
39 | the resulting files (the contents of `_site/` or `../jasper2-pages/`)
40 | to the *gh-pages* branch. This is the approach that is currently used. See
41 | [jekyll_build.yml](.github/workflows/jekyll_build.yml) for more details.
42 |
43 | 2. generate the site locally (more details below) and push the resulting
44 | HTML to a Github repository, that GitHub Pages then host;
45 |
46 | 3. build the site with [travis-ci](https://travis-ci.org/) (with goodies from
47 | [jekyll-travis](https://github.com/mfenner/jekyll-travis)) automatically pushing the
48 | generated HTML files to a *gh-pages* branch.
49 |
50 | 4. deploy the static website with Jekyll-compatible hosters, such as https://www.netlify.com/, that allow for deployment from the Github repo and publish the website using CDNs. Netlify has a free starter offer.
51 |
52 | For option **2)** simply clone this repository (*master branch*), and then run
53 | `bundle exec jekyll serve` inside the directory. Upload the resulting `_site/` (or `../jasper2-pages/`)
54 | contents to your repository (*master branch* if uploading as your personal page
55 | (e.g. username.github.io) or *gh-pages branch* if uploading as a project page
56 | (as for the [demo](https://github.com/jekyllt/jasper2/tree/gh-pages)).
57 |
58 | For option **3)** you will need to set up travis-ci for your personal fork. Briefly all you
59 | need then is to change your details in *[\_config.yml](_config.yml)* so that you can push
60 | to your github repo. You will also need to generate a secure key to add to your
61 | *[.travis.yml](.travis.yml)* (you can find more info on how to do it in that file).
62 | Also make sure you read the documentation from
63 | [jekyll-travis](https://github.com/mfenner/jekyll-travis). This approach has clear
64 | advantages in that you simply push your file changes to GitHub and all the HTML files
65 | are generated for you and pushed to *gh-pages*. Also you get to know if everything is
66 | still fine with your site builds. Don't hesitate to contact me if you still have any
67 | issues (see below about issue tracking).
68 |
69 | ### Author Pages
70 |
71 | In order to properly generate author pages you need to rename the field *author* in the
72 | front matter of every post to match that of your each author's *username* as defined
73 | in the *[\_data/authors.yml](_data/authors.yml)* file.
74 | With the latest update, multiple author blogs are now supported out of the box.
75 |
76 | ### Compiling Styles
77 |
78 | Following on the way Casper styles are compiled as [described here](https://github.com/tryghost/casper#development):
79 |
80 | Jasper2 styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need Node and Gulp installed globally. After that, from the theme's root directory:
81 |
82 | ```bash
83 | $ npm install
84 | $ gulp
85 | ```
86 |
87 | Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.
88 |
89 | ## Issues and Contributing
90 |
91 | This install builds well with Ruby v2.6.3 and Jekyll v3.9.0. If you run into any problems
92 | please log them on the [issue tracker](https://github.com/jekyllt/jasper2/issues).
93 |
94 | Feel free pull-request your patches and fixes.
95 |
96 | ## Thanks
97 |
98 | Many thanks to the Ghost team for all the design work. Also many thanks to all contributors,
99 | that help keeping the project alive and updated :smile:
100 |
101 |
102 | ## Copyright & License
103 |
104 | Same licence as the one provided by Ghost's team. See Casper's theme [license](GHOST.txt).
105 |
106 | Copyright (C) 2015-2021 - Released under the MIT License.
107 |
108 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
109 |
110 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
111 |
112 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
113 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
114 |
--------------------------------------------------------------------------------
/Rakefile:
--------------------------------------------------------------------------------
1 | #############################################################################
2 | #
3 | # Modified version of jekyllrb Rakefile
4 | # https://github.com/jekyll/jekyll/blob/master/Rakefile
5 | #
6 | #############################################################################
7 |
8 | require 'rake'
9 | require 'date'
10 | require 'yaml'
11 |
12 | CONFIG = YAML.load(File.read('_config.yml'))
13 | USERNAME = CONFIG["username"]
14 | REPO = CONFIG["repo"]
15 | SOURCE_BRANCH = CONFIG["branch"]
16 | DESTINATION_BRANCH = "gh-pages"
17 | CNAME = CONFIG["CNAME"]
18 |
19 | def check_destination
20 | unless Dir.exist? CONFIG["destination"]
21 | sh "git clone https://$GIT_NAME:$GH_TOKEN@github.com/#{USERNAME}/#{REPO}.git #{CONFIG["destination"]}"
22 | end
23 | end
24 |
25 | namespace :site do
26 | desc "Generate the site"
27 | task :build do
28 | check_destination
29 | sh "bundle exec jekyll build"
30 | end
31 |
32 | desc "Generate the site and serve locally"
33 | task :serve do
34 | check_destination
35 | sh "bundle exec jekyll serve"
36 | end
37 |
38 | desc "Generate the site, serve locally and watch for changes"
39 | task :watch do
40 | sh "bundle exec jekyll serve --watch"
41 | end
42 |
43 | desc "Generate the site and push changes to remote origin"
44 | task :deploy do
45 | # Detect pull request
46 | if ENV['TRAVIS_PULL_REQUEST'].to_s.to_i > 0
47 | puts 'Pull request detected. Not proceeding with deploy.'
48 | exit
49 | end
50 |
51 | # Configure git if this is run in Travis CI
52 | if ENV["TRAVIS"]
53 | sh "git config --global user.name $GIT_NAME"
54 | sh "git config --global user.email $GIT_EMAIL"
55 | sh "git config --global push.default simple"
56 | end
57 |
58 | # Make sure destination folder exists as git repo
59 | check_destination
60 |
61 | sh "git checkout #{SOURCE_BRANCH}"
62 | Dir.chdir(CONFIG["destination"]) { sh "git checkout #{DESTINATION_BRANCH}" }
63 |
64 | # Generate the site
65 | sh "bundle exec jekyll build"
66 |
67 | # Commit and push to github
68 | sha = `git log`.match(/[a-z0-9]{40}/)[0]
69 | Dir.chdir(CONFIG["destination"]) do
70 | # check if there is anything to add and commit, and pushes it
71 | sh "if [ -n '$(git status)' ]; then
72 | echo '#{CNAME}' > ./CNAME;
73 | git add --all .;
74 | git commit -m 'Updating to #{USERNAME}/#{REPO}@#{sha}.';
75 | git push --quiet origin #{DESTINATION_BRANCH};
76 | fi"
77 | puts "Pushed updated branch #{DESTINATION_BRANCH} to GitHub Pages"
78 | end
79 | end
80 | end
81 |
--------------------------------------------------------------------------------
/_config.yml:
--------------------------------------------------------------------------------
1 | # Jekyll configuration
2 | markdown: kramdown
3 | highlighter: rouge
4 | paginate: 100 # it will paginate after this number
5 | language: 'en-uk'
6 | words_per_minute: 200
7 |
8 | # edit baseurl to simply '/' if using as your personal page (instead of a project page)
9 | baseurl: /jasper2/
10 |
11 | # Website info
12 | title: Ghost
13 | description: The professional publishing platform
14 | cover: assets/images/blog-cover.jpg
15 | logo: assets/images/blog-icon.png
16 | logo_dark: assets/images/favicon.png
17 | favicon: assets/images/favicon.png
18 | CNAME: #add cname for website to be created
19 |
20 | # Social info
21 | navigation: True # show the navbar links
22 | subscribers: True # you need to connect an external service for this to work,
23 | # if 'True' the submit button is disabled for now, but you can change that
24 | # by editing `_includes/subscribe-form.html`
25 | twitter: tryghost # replace by your username
26 | facebook: ghost # replace by your username
27 |
28 | # Disqus
29 | disqus: False
30 | disqus_shortname: jekyllt # replace with your disqus username
31 |
32 | # Google Analytics
33 | google_analytics: UA-69281367-1 # replace with your GA tracking identifier
34 |
35 | # Permalinks
36 | permalink: /:title
37 | # permalink: /author/:author
38 | # permalink: /tag/:tag
39 |
40 | # Authors' info in `_data/authors.yml`
41 | # Tags' info in `_data/tags_info.yml`
42 |
43 | # gems and other configs
44 | plugins_dir: [_plugins]
45 | plugins: [jekyll-paginate, jekyll-feed]
46 |
47 | feed:
48 | path: feed.xml
49 |
50 | # Additional settings available on the front-matter
51 | # Site logo in the index.html (as in demo.ghost.io)
52 | # Author's page cover in _layouts/author.html
53 | # The same for page.html and tag.html layouts
54 | # Post's page cover as a per-post basis _posts/...
55 | # Disqus comments as a per-post basis
56 | # ...
57 |
58 | # Settings for building master branch with travis-ci
59 | # with jekyll-travis
60 |
61 | # Settings for deploy rake task
62 | # Username and repo of Github repo, e.g.
63 | # https://github.com/USERNAME/REPO.git
64 | # username defaults to ENV['GIT_NAME'] used by Travis
65 | # repo defaults to USERNAME.github.io
66 | # Branch defaults to "source" for USERNAME.github.io
67 | # or "master" otherwise
68 | safe: False
69 | lsi: False
70 | username: jekyllt
71 | repo: jasper2
72 | branch: master
73 | relative_source: ../jasper2/
74 | destination: ../jasper2-pages/
75 | production_url: https://jekyllt.github.io/jasper2/
76 | source_url: https://github.com/jekyllt/jasper2/
77 |
78 | exclude:
79 | - assets/css
80 | - node_modules
81 | - vendor
82 | - .travis.yml
83 | - Gemfile
84 | - Gemfile.lock
85 | - GHOST.txt
86 | - gulpfile.js
87 | - LICENSE
88 | - package.json
89 | - package-lock.json
90 | - Rakefile
91 | - README.md
92 | - script.py
93 | - changelog.md
94 | - "*.Rmd"
95 | - .git*
96 |
--------------------------------------------------------------------------------
/_data/authors.yml:
--------------------------------------------------------------------------------
1 | ghost:
2 | username: ghost
3 | name: Ghost
4 | url_full: http://jekyllt.github.io/jasper2/
5 | url: jekyllt.github.io/jasper2
6 | bio: The professional publishing platform
7 | picture: assets/images/ghost.png
8 | facebook: ghost
9 | twitter: tryghost
10 | cover: False
11 | hannah:
12 | username: hannah
13 | name: Hannah Wolfe
14 | location: London, UK
15 | url_full: http://hannah.wf/
16 | url: hannah.wf
17 | bio: Hannah is the co-founder and lead developer at Ghost. She spends her days looking after Ghost's developer community, tracking down bugs & ensuring Ghost(Pro) is a happy place.
18 | picture: assets/images/hannah.jpg
19 | facebook: False
20 | twitter: erisds
21 | cover: assets/images/hannah-cover.jpg
22 | john:
23 | username: john
24 | name: John O'Nolan
25 | location: On a plane
26 | url_full: http://john.onolan.org/
27 | url: john.onolan.org
28 | bio: Founder at Ghost.org. Writes about open source, startup life, non-profits, and publishing platforms. Travels the world with a bag of kites.
29 | picture: assets/images/john.jpg
30 | facebook: False
31 | twitter: False
32 | cover: False
33 | lewis:
34 | username: lewis
35 | name: Lewis Carroll
36 | location: Cheshire, England
37 | url_full: False
38 | url: False
39 | bio: My real name is Charles Lutwidge Dodgson, but people call me Lewis. I'm an English writer, mathematician, logician, Anglican deacon and photographer. People know me best for writing about Alice.
40 | picture: assets/images/lewis.jpeg
41 | facebook: False
42 | twitter: False
43 | cover: False
44 | abraham:
45 | username: abraham
46 | name: Abraham Lincoln
47 | location: Kentucky, USA
48 | url_full: False
49 | url: False
50 | bio: I was the 16th president of the USA until I was assassinated in April of 1865. I led the US through its Civil War - its bloodiest and greatest moral, constitutional and political crisis.
51 | picture: assets/images/abraham.jpg
52 | facebook: False
53 | twitter: False
54 | cover: False
55 | edgar:
56 | username: edgar
57 | name: Edgar Rice Burroughs
58 | location: Chicago, Illinois
59 | url_full: False
60 | url: False
61 | bio: I'm an American novelist, best known for my work writing about a brave jungle hero called Tarzan and his muse, Jane.
62 | picture: assets/images/edgar.gif
63 | facebook: False
64 | twitter: False
65 | cover: False
66 | martin:
67 | username: martin
68 | name: Martin Luther King
69 | location: Memphis, Tennessee
70 | url_full: False
71 | url: False
72 | bio: An American pastor, activist, humanitarian. People know me for leading the African-American Civil Rights movement using nonviolent civil disobedience.
73 | picture: assets/images/martin.jpg
74 | facebook: False
75 | twitter: False
76 | cover: False
77 |
--------------------------------------------------------------------------------
/_data/tags.yml:
--------------------------------------------------------------------------------
1 | speeches:
2 | name: speeches
3 | description: Some of the greatest words ever spoken.
4 | cover: assets/images/speeches.jpg
5 | fiction:
6 | name: fiction
7 | description: False
8 | cover: False
9 | fables:
10 | name: fables
11 | description: A series of short stories that make you think.
12 | cover: assets/images/fables.jpg
13 | getting-started:
14 | name: getting-started
15 | description: False
16 | cover: False
17 |
--------------------------------------------------------------------------------
/_includes/analytics.html:
--------------------------------------------------------------------------------
1 |
2 |
12 |
--------------------------------------------------------------------------------
/_includes/author_pagination.html:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/_includes/dynamic_tag_info.html:
--------------------------------------------------------------------------------
1 |
2 | {% assign decoded_url = page.url | url_decode %}
3 | {% for tag in site.data.tags %}
4 | {% if decoded_url contains tag[1].name %}
5 | {% assign cover = tag[1].cover %}
6 | {% assign tag_description = tag[1].description %}
7 | {% endif %}
8 | {% endfor %}
9 |
--------------------------------------------------------------------------------
/_includes/dynamic_title.html:
--------------------------------------------------------------------------------
1 |
2 | {% if page.url %}
3 | {% if page.url contains "tag/" %}
4 | {% assign title = page.url | remove: 'tag' | remove: '/' | url_decode | replace: '-', ' ' | capitalizeall %}
5 | {% elsif page.url contains "author/" %}
6 | {% assign username = page.url | remove: 'author' | remove: '/' | replace: '-', ' ' | remove: ' ' %}
7 | {% for author in site.data.authors %}
8 | {% if author[1].username == username %}
9 | {% assign title = author[1].name %}
10 | {% endif %}
11 | {% endfor %}
12 | {% endif %}
13 | {% endif %}
14 | {% if title %}
15 | {% assign title = title | append: ' - ' | append: site.title %}
16 | {% endif %}
17 |
--------------------------------------------------------------------------------
/_includes/facebook.html:
--------------------------------------------------------------------------------
1 |
2 |
--------------------------------------------------------------------------------
/_includes/floating-header.html:
--------------------------------------------------------------------------------
1 |
42 |
43 |
--------------------------------------------------------------------------------
/_plugins/jekyll-autgenerator.rb:
--------------------------------------------------------------------------------
1 | module Jekyll
2 |
3 | class AuthorsGenerator < Generator
4 |
5 | safe true
6 |
7 | def generate(site)
8 | site.data['authors'].each do |author, data|
9 | posts = [author, posts_by_author(site, author)]
10 | build_subpages(site, 'author', posts)
11 | end
12 | end
13 |
14 | def build_subpages(site, type, posts)
15 | posts[1] = posts[1].sort_by { |p| -p.date.to_f }
16 | atomize(site, type, posts)
17 | paginate(site, type, posts)
18 | end
19 |
20 | def atomize(site, type, posts)
21 | path = "/author/#{posts[0]}"
22 | atom = AtomPageAuthor.new(site, site.source, path, type, posts[0], posts[1])
23 | site.pages << atom
24 | end
25 |
26 | def paginate(site, type, posts)
27 | pages = Jekyll::Paginate::Pager.calculate_pages(posts[1], site.config['paginate'].to_i)
28 | (1..pages).each do |num_page|
29 | pager = Jekyll::Paginate::Pager.new(site, num_page, posts[1], pages)
30 | path = "/author/#{posts[0]}"
31 | if num_page > 1
32 | path = path + "/page#{num_page}"
33 | end
34 | newpage = GroupSubPageAuthor.new(site, site.source, path, type, posts[0])
35 | newpage.pager = pager
36 | site.pages << newpage
37 |
38 | end
39 | end
40 |
41 | private
42 |
43 | def posts_by_author(site, author)
44 | site.posts.docs.select { |post| post.data['author'] == author }
45 | end
46 | end
47 |
48 | class GroupSubPageAuthor < Page
49 | def initialize(site, base, dir, type, val)
50 | @site = site
51 | @base = base
52 | @dir = dir
53 | @name = 'index.html'
54 |
55 | self.process(@name)
56 | self.read_yaml(File.join(base, '_layouts'), "author.html")
57 | self.data["grouptype"] = type
58 | self.data[type] = val
59 | end
60 | end
61 |
62 | class AtomPageAuthor < Page
63 | def initialize(site, base, dir, type, val, posts)
64 | @site = site
65 | @base = base
66 | @dir = dir
67 | @name = 'feed.xml'
68 |
69 | self.process(@name)
70 | self.read_yaml(File.join(base, '_layouts'), "feed.xml")
71 | self.data[type] = val
72 | self.data["grouptype"] = type
73 | self.data["posts"] = posts[0..9]
74 | end
75 | end
76 | end
77 |
--------------------------------------------------------------------------------
/_plugins/jekyll-capitalize-all.rb:
--------------------------------------------------------------------------------
1 | require 'liquid'
2 | require 'uri'
3 |
4 | # Capitalize all words of the input
5 | module CapitalizeAll
6 | def capitalizeall(words)
7 | return words.split(' ').map(&:capitalize).join(' ')
8 | end
9 | end
10 |
11 | Liquid::Template.register_filter(CapitalizeAll)
12 |
--------------------------------------------------------------------------------
/_plugins/jekyll-tagsgenerator.rb:
--------------------------------------------------------------------------------
1 | require 'slugify'
2 | module Jekyll
3 |
4 | class TagsGenerator < Generator
5 |
6 | safe true
7 |
8 | def generate(site)
9 | site.tags.each do |tag|
10 | build_subpages(site, "tag", tag)
11 | end
12 | end
13 |
14 | def build_subpages(site, type, posts)
15 | posts[1] = posts[1].sort_by { |p| -p.date.to_f }
16 | atomize(site, type, posts)
17 | paginate(site, type, posts)
18 | end
19 |
20 | def atomize(site, type, posts)
21 | path = "/tag/" + posts[0].slugify
22 | atom = AtomPageTags.new(site, site.source, path, type, posts[0], posts[1])
23 | site.pages << atom
24 | end
25 |
26 | def paginate(site, type, posts)
27 | pages = Jekyll::Paginate::Pager.calculate_pages(posts[1], site.config['paginate'].to_i)
28 | (1..pages).each do |num_page|
29 | pager = Jekyll::Paginate::Pager.new(site, num_page, posts[1], pages)
30 | path = "/tag/" + posts[0].slugify
31 | if num_page > 1
32 | path = path + "/page#{num_page}"
33 | end
34 | newpage = GroupSubPageTags.new(site, site.source, path, type, posts[0])
35 | newpage.pager = pager
36 | site.pages << newpage
37 |
38 | end
39 | end
40 | end
41 |
42 | class GroupSubPageTags < Page
43 | def initialize(site, base, dir, type, val)
44 | @site = site
45 | @base = base
46 | @dir = dir
47 | @name = 'index.html'
48 |
49 | self.process(@name)
50 | self.read_yaml(File.join(base, '_layouts'), "tag.html")
51 | self.data["grouptype"] = type
52 | self.data[type] = val
53 | end
54 | end
55 |
56 | class AtomPageTags < Page
57 | def initialize(site, base, dir, type, val, posts)
58 | @site = site
59 | @base = base
60 | @dir = dir
61 | @name = 'feed.xml'
62 |
63 | self.process(@name)
64 | self.read_yaml(File.join(base, '_layouts'), "feed.xml")
65 | self.data[type] = val
66 | self.data["grouptype"] = type
67 | self.data["posts"] = posts[0..9]
68 | end
69 | end
70 | end
71 |
--------------------------------------------------------------------------------
/_posts/1863-11-19-gettysburg-address.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: assets/images/bus.jpg
5 | navigation: True
6 | title: Gettysburg Address
7 | date: 1863-11-19 10:18:00
8 | tags:
9 | class: post-template
10 | subclass: 'post'
11 | author: abraham
12 | ---
13 |
14 | Fourscore and seven years ago our fathers brought forth on this continent, a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.
15 |
16 | Now we are engaged in a great civil war, testing whether that nation, or any nation so conceived and so dedicated, can long endure. We are met on a great battle-field of that war. We have come to dedicate a portion of that field, as a final resting place for those who here gave their lives that that nation might live. It is altogether fitting and proper that we should do this.
17 |
18 | But, in a larger sense, we can not dedicate-we can not consecrate-we can not hallow-this ground. The brave men, living and dead, who struggled here, have consecrated it, far above our poor power to add or detract. The world will little note, nor long remember what we say here, but it can never forget what they did here. It is for us the living, rather, to be dedicated here to the unfinished work which they who fought here have thus far so nobly advanced. It is rather for us to be here dedicated to the great task remaining before us-that from these honored dead we take increased devotion to that cause for which they gave the last full measure of devotion-that we here highly resolve that these dead shall not have died in vain-that this nation, under God, shall have a new birth of freedom-and that government of the people, by the people, for the people shall not perish from the earth.
19 |
--------------------------------------------------------------------------------
/_posts/1912-07-24-out-to-sea.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: 'assets/images/waves.jpg'
5 | navigation: True
6 | title: Out to Sea
7 | date: 1912-07-24 10:18:00
8 | tags: fiction
9 | class: post-template
10 | subclass: 'post'
11 | author: edgar
12 | ---
13 |
14 | I had this story from one who had no business to tell it to me, or to any other. I may credit the seductive influence of an old vintage upon the narrator for the beginning of it, and my own skeptical incredulity during the days that followed for the balance of the strange tale.
15 |
16 | When my convivial host discovered that he had told me so much, and that I was prone to doubtfulness, his foolish pride assumed the task the old vintage had commenced, and so he unearthed written evidence in the form of musty manuscript, and dry official records of the British Colonial Office to support many of the salient features of his remarkable narrative.
17 |
18 | I do not say the story is true, for I did not witness the happenings which it portrays, but the fact that in the telling of it to you I have taken fictitious names for the principal characters quite sufficiently evidences the sincerity of my own belief that it MAY be true.
19 |
20 | The yellow, mildewed pages of the diary of a man long dead, and the records of the Colonial Office dovetail perfectly with the narrative of my convivial host, and so I give you the story as I painstakingly pieced it out from these several various agencies.
21 |
22 | If you do not find it credible you will at least be as one with me in acknowledging that it is unique, remarkable, and interesting.
23 |
24 | From the records of the Colonial Office and from the dead man's diary we learn that a certain young English nobleman, whom we shall call John Clayton, Lord Greystoke, was commissioned to make a peculiarly delicate investigation of conditions in a British West Coast African Colony from whose simple native inhabitants another European power was known to be recruiting soldiers for its native army, which it used solely for the forcible collection of rubber and ivory from the savage tribes along the Congo and the Aruwimi. The natives of the British Colony complained that many of their young men were enticed away through the medium of fair and glowing promises, but that few if any ever returned to their families.
25 |
26 | The Englishmen in Africa went even further, saying that these poor blacks were held in virtual slavery, since after their terms of enlistment expired their ignorance was imposed upon by their white officers, and they were told that they had yet several years to serve.
27 |
28 | And so the Colonial Office appointed John Clayton to a new post in British West Africa, but his confidential instructions centered on a thorough investigation of the unfair treatment of black British subjects by the officers of a friendly European power. Why he was sent, is, however, of little moment to this story, for he never made an investigation, nor, in fact, did he ever reach his destination.
29 |
30 | Clayton was the type of Englishman that one likes best to associate with the noblest monuments of historic achievement upon a thousand victorious battlefields--a strong, virile man --mentally, morally, and physically.
31 |
32 | In stature he was above the average height; his eyes were gray, his features regular and strong; his carriage that of perfect, robust health influenced by his years of army training.
33 |
34 | Political ambition had caused him to seek transference from the army to the Colonial Office and so we find him, still young, entrusted with a delicate and important commission in the service of the Queen.
35 |
36 | When he received this appointment he was both elated and appalled. The preferment seemed to him in the nature of a well-merited reward for painstaking and intelligent service, and as a stepping stone to posts of greater importance and responsibility; but, on the other hand, he had been married to the Hon. Alice Rutherford for scarce a three months, and it was the thought of taking this fair young girl into the dangers and isolation of tropical Africa that appalled him.
37 |
38 | For her sake he would have refused the appointment, but she would not have it so. Instead she insisted that he accept, and, indeed, take her with him.
39 |
40 | There were mothers and brothers and sisters, and aunts and cousins to express various opinions on the subject, but as to what they severally advised history is silent.
41 |
42 | We know only that on a bright May morning in 1888, John, Lord Greystoke, and Lady Alice sailed from Dover on their way to Africa.
43 |
44 | A month later they arrived at Freetown where they chartered a small sailing vessel, the Fuwalda, which was to bear them to their final destination.
45 |
46 | And here John, Lord Greystoke, and Lady Alice, his wife, vanished from the eyes and from the knowledge of men.
47 |
48 | Two months after they weighed anchor and cleared from the port of Freetown a half dozen British war vessels were scouring the south Atlantic for trace of them or their little vessel, and it was almost immediately that the wreckage was found upon the shores of St. Helena which convinced the world that the Fuwalda had gone down with all on board, and hence the search was stopped ere it had scarce begun; though hope lingered in longing hearts for many years.
49 |
50 | The Fuwalda, a barkentine of about one hundred tons, was a vessel of the type often seen in coastwise trade in the far southern Atlantic, their crews composed of the offscourings of the sea--unhanged murderers and cutthroats of every race and every nation.
51 |
52 | The Fuwalda was no exception to the rule. Her officers were swarthy bullies, hating and hated by their crew. The captain, while a competent seaman, was a brute in his treatment of his men. He knew, or at least he used, but two arguments in his dealings with them--a belaying pin and a revolver--nor is it likely that the motley aggregation he signed would have understood aught else.
53 |
54 | So it was that from the second day out from Freetown John Clayton and his young wife witnessed scenes upon the deck of the Fuwalda such as they had believed were never enacted outside the covers of printed stories of the sea.
55 |
56 | It was on the morning of the second day that the first link was forged in what was destined to form a chain of circumstances ending in a life for one then unborn such as has never been paralleled in the history of man.
57 |
58 | Two sailors were washing down the decks of the Fuwalda, the first mate was on duty, and the captain had stopped to speak with John Clayton and Lady Alice.
59 |
60 | The men were working backwards toward the little party who were facing away from the sailors. Closer and closer they came, until one of them was directly behind the captain. In another moment he would have passed by and this strange narrative would never have been recorded.
61 |
62 | But just that instant the officer turned to leave Lord and Lady Greystoke, and, as he did so, tripped against the sailor and sprawled headlong upon the deck, overturning the water- pail so that he was drenched in its dirty contents.
63 |
64 | For an instant the scene was ludicrous; but only for an instant. With a volley of awful oaths, his face suffused with the scarlet of mortification and rage, the captain regained his feet, and with a terrific blow felled the sailor to the deck.
65 |
66 | The man was small and rather old, so that the brutality of the act was thus accentuated. The other seaman, however, was neither old nor small--a huge bear of a man, with fierce black mustachios, and a great bull neck set between massive shoulders.
67 |
68 | As he saw his mate go down he crouched, and, with a low snarl, sprang upon the captain crushing him to his knees with a single mighty blow.
69 |
70 | From scarlet the officer's face went white, for this was mutiny; and mutiny he had met and subdued before in his brutal career. Without waiting to rise he whipped a revolver from his pocket, firing point blank at the great mountain of muscle towering before him; but, quick as he was, John Clayton was almost as quick, so that the bullet which was intended for the sailor's heart lodged in the sailor's leg instead, for Lord Greystoke had struck down the captain's arm as he had seen the weapon flash in the sun.
71 |
72 | Words passed between Clayton and the captain, the former making it plain that he was disgusted with the brutality displayed toward the crew, nor would he countenance anything further of the kind while he and Lady Greystoke remained passengers.
73 |
74 | The captain was on the point of making an angry reply, but, thinking better of it, turned on his heel and black and scowling, strode aft.
75 |
76 | He did not care to antagonize an English official, for the Queen's mighty arm wielded a punitive instrument which he could appreciate, and which he feared--England's far-reaching navy.
77 |
78 | The two sailors picked themselves up, the older man assisting his wounded comrade to rise. The big fellow, who was known among his mates as Black Michael, tried his leg gingerly, and, finding that it bore his weight, turned to Clayton with a word of gruff thanks.
79 |
80 | Though the fellow's tone was surly, his words were evidently well meant. Ere he had scarce finished his little speech he had turned and was limping off toward the forecastle with the very apparent intention of forestalling any further conversation.
81 |
82 | They did not see him again for several days, nor did the captain accord them more than the surliest of grunts when he was forced to speak to them.
83 |
84 | They took their meals in his cabin, as they had before the unfortunate occurrence; but the captain was careful to see that his duties never permitted him to eat at the same time.
85 |
86 | The other officers were coarse, illiterate fellows, but little above the villainous crew they bullied, and were only too glad to avoid social intercourse with the polished English noble and his lady, so that the Claytons were left very much to themselves.
87 |
88 | This in itself accorded perfectly with their desires, but it also rather isolated them from the life of the little ship so that they were unable to keep in touch with the daily happenings which were to culminate so soon in bloody tragedy.
89 |
--------------------------------------------------------------------------------
/_posts/1948-12-12-the-purpose-of-education.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: assets/images/grapes.jpg
5 | navigation: True
6 | title: The Purpose of Education
7 | date: 1948-12-12 10:18:00
8 | tags: speeches
9 | class: post-template
10 | subclass: 'post'
11 | author: martin
12 | ---
13 |
14 | As I engage in the so-called "bull sessions" around and about the school, I too often find that most college men have a misconception of the purpose of education. Most of the "brethren" think that education should equip them with the proper instruments of exploitation so that they can forever trample over the masses. Still others think that education should furnish them with noble ends rather than means to an end.
15 |
16 | It seems to me that education has a two-fold function to perform in the life of man and in society: the one is utility and the other is culture. Education must enable a man to become more efficient, to achieve with increasing facility the ligitimate goals of his life.
17 |
18 | Education must also train one for quick, resolute and effective thinking. To think incisively and to think for one's self is very difficult. We are prone to let our mental life become invaded by legions of half truths, prejudices, and propaganda. At this point, I often wonder whether or not education is fulfilling its purpose. A great majority of the so-called educated people do not think logically and scientifically. Even the press, the classroom, the platform, and the pulpit in many instances do not give us objective and unbiased truths. To save man from the morass of propaganda, in my opinion, is one of the chief aims of education. Education must enable one to sift and weigh evidence, to discern the true from the false, the real from the unreal, and the facts from the fiction.
19 |
20 | The function of education, therefore, is to teach one to think intensively and to think critically. But education which stops with efficiency may prove the greatest menace to society. The most dangerous criminal may be the man gifted with reason, but with no morals.
21 |
22 | The late Eugene Talmadge, in my opinion, possessed one of the better minds of Georgia, or even America. Moreover, he wore the Phi Beta Kappa key. By all measuring rods, Mr. Talmadge could think critically and intensively; yet he contends that I am an inferior being. Are those the types of men we call educated?
23 |
24 | We must remember that intelligence is not enough. Intelligence plus character--that is the goal of true education. The complete education gives one not only power of concentration, but worthy objectives upon which to concentrate. The broad education will, therefore, transmit to one not only the accumulated knowledge of the race but also the accumulated experience of social living.
25 |
26 | If we are not careful, our colleges will produce a group of close-minded, unscientific, illogical propagandists, consumed with immoral acts. Be careful, "brethren!" Be careful, teachers!
27 |
--------------------------------------------------------------------------------
/_posts/1963-08-28-i-have-a-dream.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: assets/images/sky.jpg
5 | navigation: True
6 | title: I Have a Dream
7 | date: 1963-08-28 10:18:00
8 | tags: speeches
9 | class: post-template
10 | subclass: 'post'
11 | author: martin
12 | ---
13 |
14 | I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.
15 |
16 | Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of their captivity.
17 |
18 | But one hundred years later, the Negro still is not free. One hundred years later, the life of the Negro is still sadly crippled by the manacles of segregation and the chains of discrimination. One hundred years later, the Negro lives on a lonely island of poverty in the midst of a vast ocean of material prosperity. One hundred years later, the Negro is still languished in the corners of American society and finds himself an exile in his own land. And so we've come here today to dramatize a shameful condition.
19 |
20 | In a sense we've come to our nation's capital to cash a check. When the architects of our republic wrote the magnificent words of the Constitution and the Declaration of Independence, they were signing a promissory note to which every American was to fall heir. This note was a promise that all men, yes, black men as well as white men, would be guaranteed the "unalienable Rights" of "Life, Liberty and the pursuit of Happiness." It is obvious today that America has defaulted on this promissory note, insofar as her citizens of color are concerned. Instead of honoring this sacred obligation, America has given the Negro people a bad check, a check which has come back marked "insufficient funds."
21 |
22 | But we refuse to believe that the bank of justice is bankrupt. We refuse to believe that there are insufficient funds in the great vaults of opportunity of this nation. And so, we've come to cash this check, a check that will give us upon demand the riches of freedom and the security of justice.
23 |
24 | We have also come to this hallowed spot to remind America of the fierce urgency of Now. This is no time to engage in the luxury of cooling off or to take the tranquilizing drug of gradualism. Now is the time to make real the promises of democracy. Now is the time to rise from the dark and desolate valley of segregation to the sunlit path of racial justice. Now is the time to lift our nation from the quicksands of racial injustice to the solid rock of brotherhood. Now is the time to make justice a reality for all of God's children.
25 |
26 | It would be fatal for the nation to overlook the urgency of the moment. This sweltering summer of the Negro's legitimate discontent will not pass until there is an invigorating autumn of freedom and equality. Nineteen sixty-three is not an end, but a beginning. And those who hope that the Negro needed to blow off steam and will now be content will have a rude awakening if the nation returns to business as usual. And there will be neither rest nor tranquility in America until the Negro is granted his citizenship rights. The whirlwinds of revolt will continue to shake the foundations of our nation until the bright day of justice emerges.
27 |
28 | But there is something that I must say to my people, who stand on the warm threshold which leads into the palace of justice: In the process of gaining our rightful place, we must not be guilty of wrongful deeds. Let us not seek to satisfy our thirst for freedom by drinking from the cup of bitterness and hatred. We must forever conduct our struggle on the high plane of dignity and discipline. We must not allow our creative protest to degenerate into physical violence. Again and again, we must rise to the majestic heights of meeting physical force with soul force.
29 |
30 | The marvelous new militancy which has engulfed the Negro community must not lead us to a distrust of all white people, for many of our white brothers, as evidenced by their presence here today, have come to realize that their destiny is tied up with our destiny. And they have come to realize that their freedom is inextricably bound to our freedom.
31 |
32 | We cannot walk alone.
33 |
34 | And as we walk, we must make the pledge that we shall always march ahead.
35 |
36 | We cannot turn back.
37 |
38 | There are those who are asking the devotees of civil rights, "When will you be satisfied?" We can never be satisfied as long as the Negro is the victim of the unspeakable horrors of police brutality. We can never be satisfied as long as our bodies, heavy with the fatigue of travel, cannot gain lodging in the motels of the highways and the hotels of the cities. We cannot be satisfied as long as the negro's basic mobility is from a smaller ghetto to a larger one. We can never be satisfied as long as our children are stripped of their self-hood and robbed of their dignity by signs stating: "For Whites Only." We cannot be satisfied as long as a Negro in Mississippi cannot vote and a Negro in New York believes he has nothing for which to vote. No, no, we are not satisfied, and we will not be satisfied until "justice rolls down like waters, and righteousness like a mighty stream."
39 |
40 | I am not unmindful that some of you have come here out of great trials and tribulations. Some of you have come fresh from narrow jail cells. And some of you have come from areas where your quest -- quest for freedom left you battered by the storms of persecution and staggered by the winds of police brutality. You have been the veterans of creative suffering. Continue to work with the faith that unearned suffering is redemptive. Go back to Mississippi, go back to Alabama, go back to South Carolina, go back to Georgia, go back to Louisiana, go back to the slums and ghettos of our northern cities, knowing that somehow this situation can and will be changed.
41 |
42 | Let us not wallow in the valley of despair, I say to you today, my friends.
43 |
44 | And so even though we face the difficulties of today and tomorrow, I still have a dream. It is a dream deeply rooted in the American dream.
45 |
46 | I have a dream that one day this nation will rise up and live out the true meaning of its creed: "We hold these truths to be self-evident, that all men are created equal."
47 |
48 | I have a dream that one day on the red hills of Georgia, the sons of former slaves and the sons of former slave owners will be able to sit down together at the table of brotherhood.
49 |
50 | I have a dream that one day even the state of Mississippi, a state sweltering with the heat of injustice, sweltering with the heat of oppression, will be transformed into an oasis of freedom and justice.
51 |
52 | I have a dream that my four little children will one day live in a nation where they will not be judged by the color of their skin but by the content of their character.
53 |
54 | I have a **dream** today!
55 |
56 | I have a dream that one day, down in Alabama, with its vicious racists, with its governor having his lips dripping with the words of "interposition" and "nullification" -- one day right there in Alabama little black boys and black girls will be able to join hands with little white boys and white girls as sisters and brothers.
57 |
58 | I have a **dream** today!
59 |
60 | I have a dream that one day every valley shall be exalted, and every hill and mountain shall be made low, the rough places will be made plain, and the crooked places will be made straight; "and the glory of the Lord shall be revealed and all flesh shall see it together."
61 |
62 | This is our hope, and this is the faith that I go back to the South with.
63 |
64 | With this faith, we will be able to hew out of the mountain of despair a stone of hope. With this faith, we will be able to transform the jangling discords of our nation into a beautiful symphony of brotherhood. With this faith, we will be able to work together, to pray together, to struggle together, to go to jail together, to stand up for freedom together, knowing that we will be free one day.
65 |
66 | And this will be the day -- this will be the day when all of God's children will be able to sing with new meaning:
67 |
68 | > My country 'tis of thee, sweet land of liberty, of thee I sing.
69 | >
70 | > Land where my fathers died, land of the Pilgrim's pride,
71 | >
72 | > From every mountainside, let freedom ring!
73 |
74 |
75 | And if America is to be a great nation, this must become true.
76 |
77 | And so let freedom ring from the prodigious hilltops of New Hampshire.
78 |
79 | > Let freedom ring from the mighty mountains of New York.
80 | >
81 | > Let freedom ring from the heightening Alleghenies of Pennsylvania.
82 | >
83 | > Let freedom ring from the snow-capped Rockies of Colorado.
84 | >
85 | > Let freedom ring from the curvaceous slopes of California.
86 |
87 |
88 | But not only that:
89 |
90 | > Let freedom ring from Stone Mountain of Georgia.
91 | >
92 | > Let freedom ring from Lookout Mountain of Tennessee.
93 | >
94 | > Let freedom ring from every hill and molehill of Mississippi.
95 | >
96 | > From every mountainside, let freedom ring.
97 |
98 |
99 | And when this happens, and when we allow freedom ring, when we let it ring from every village and every hamlet, from every state and every city, we will be able to speed up that day when all of God's children, black men and white men, Jews and Gentiles, Protestants and Catholics, will be able to join hands and sing in the words of the old Negro spiritual:
100 |
101 | *Free at last! Free at last!*
102 |
103 | *Thank God Almighty, we are free at last!*
104 |
--------------------------------------------------------------------------------
/_posts/2014-08-12-the-businessman-and-fisherman.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: assets/images/water.jpg
5 | navigation: True
6 | title: The Businessman & The Fisherman
7 | date: 2014-08-12 10:18:00
8 | tags: fables
9 | class: post-template
10 | subclass: 'post'
11 | logo: assets/images/ghost.png
12 | author: hannah
13 | ---
14 |
15 | An American businessman took a vacation to a small coastal Mexican village on doctor’s orders. Unable to sleep after an urgent phone call from the office the first morning, he walked out to the pier to clear his head. A small boat with just one fisherman had docked, and inside the boat were several large yellowfin tuna. The American complimented the Mexican on the quality of his fish.
16 |
17 | “How long did it take you to catch them?” the American asked.
18 |
19 | “Only a little while,” the Mexican replied in surprisingly good English.
20 |
21 | “Why don’t you stay out longer and catch more fish?” the American then asked.
22 |
23 | “I have enough to support my family and give a few to friends,” the Mexican said as he unloaded them into a basket.
24 |
25 | “But… What do you do with the rest of your time?”
26 |
27 | The Mexican looked up and smiled. “I sleep late, fish a little, play with my children, take a siesta with my wife, Julia, and stroll into the village each evening, where I sip wine and play guitar with my amigos. I have a full and busy life, señor.”
28 |
29 | The American laughed and stood tall. “Sir, I’m a Harvard M.B.A. and can help you. You should spend more time fishing, and with the proceeds, buy a bigger boat. In no time, you could buy several boats with the increased haul. Eventually, you would have a fleet of fishing boats.”
30 |
31 | He continued, “Instead of selling your catch to a middleman, you would sell directly to the consumers, eventually opening your own cannery. You would control the product, processing, and distribution. You would need to leave this small coastal fishing village, of course, and move to Mexico City, then to Los Angeles, and eventually to New York City, where you could run your expanded enterprise with proper management.
32 |
33 | The Mexican fisherman asked, “But, señor, how long will all this take?”
34 |
35 | To which the American replied, “15-20 years, 25 tops.”
36 |
37 | “But what then, señor?”
38 |
39 | The American laughed and said, “That’s the best part. When the time is right, you would announce an IPO and sell your company stock to the public and become very rich. You would make millions.”
40 |
41 | “Millions señor? Then what?"
42 |
43 | “Then you would retire and move to a small coastal fishing village, where you would sleep late, fish a little, play with your kids, take a siesta with your wife, and stroll in to the village in the evenings where you could sip wine and play your guitar with your amigos.”
44 |
45 |
46 | Adapted from the "Anekdote zur Senkung der Arbeitsmoral" by **Heinrich Böll**
47 |
48 | An influential German write and Nobel Prize for Literature in 1972.
49 |
--------------------------------------------------------------------------------
/_posts/2017-07-27-advanced-markdown.html:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | current: post
4 | cover: assets/images/advanced.jpg
5 | navigation: True
6 | title: Advanced Markdown tips
7 | date: 2017-07-27 05:00:00
8 | tags: [Getting started]
9 | class: post-template
10 | subclass: 'post'
11 | author: ghost
12 | ---
13 |
14 |
15 |
There are lots of powerful things you can do with the Ghost editor
16 |
If you've gotten pretty comfortable with all the basics of writing in Ghost, then you may enjoy some more advanced tips about the types of things you can do with Markdown!
17 |
As with the last post about the editor, you'll want to be actually editing this post as you read it so that you can see all the Markdown code we're using.
18 |
Special formatting
19 |
As well as bold and italics, you can also use some other special formatting in Markdown when the need arises, for example:
20 |
21 |
strike through
22 |
highlight
23 |
*escaped characters*
24 |
25 |
Writing code blocks
26 |
There are two types of code elements which can be inserted in Markdown, the first is inline, and the other is block. Inline code is formatted by wrapping any word or words in back-ticks, like this. Larger snippets of code can be displayed across multiple lines using triple back ticks:
If you want to get really fancy, you can even add syntax highlighting using Prism.js.
32 |
Full bleed images
33 |
One neat trick which you can use in Markdown to distinguish between different types of images is to add a #hash value to the end of the source URL, and then target images containing the hash with special styling. For example:
This creates full-bleed images in the Casper theme, which stretch beyond their usual boundaries right up to the edge of the window. Every theme handles these types of things slightly differently, but it's a great trick to play with if you want to have a variety of image sizes and styles.
Another way to insert links in markdown is using reference lists. You might want to use this style of linking to cite reference material in a Wikipedia-style. All of the links are listed at the end of the document, so you can maintain full separation between content and its source or reference.
44 |
Creating footnotes
45 |
The quick brown fox[1] jumped over the lazy dog[2].
46 |
Footnotes are a great way to add additional contextual details when appropriate. Ghost will automatically add footnote content to the very end of your post.
47 |
Full HTML
48 |
Perhaps the best part of Markdown is that you're never limited to just Markdown. You can write HTML directly in the Ghost editor and it will just work as HTML usually does. No limits! Here's a standard YouTube embed code as an example:
Ghost has a number of different user roles for your team
15 |
Authors
16 |
The base user level in Ghost is an author. Authors can write posts, edit their own posts, and publish their own posts. Authors are trusted users. If you don't trust users to be allowed to publish their own posts, you shouldn't invite them to Ghost admin.
17 |
Editors
18 |
Editors are the 2nd user level in Ghost. Editors can do everything that an Author can do, but they can also edit and publish the posts of others - as well as their own. Editors can also invite new authors to the site.
19 |
Administrators
20 |
The top user level in Ghost is Administrator. Again, administrators can do everything that Authors and Editors can do, but they can also edit all site settings and data, not just content. Additionally, administrators have full access to invite, manage or remove any other user of the site.
21 |
The Owner
22 |
There is only ever one owner of a Ghost site. The owner is a special user which has all the same permissions as an Administrator, but with two exceptions: The Owner can never be deleted. And in some circumstances the owner will have access to additional special settings if applicable — for example, billing details, if using Ghost(Pro).
23 |
24 |
It's a good idea to ask all of your users to fill out their user profiles, including bio and social links. These will populate rich structured data for posts and generally create more opportunities for themes to fully populate their design.
Sometimes you might want to put your site behind closed doors
15 |
If you've got a publication that you don't want the world to see yet because it's not ready to launch, you can hide your Ghost site behind a simple shared pass-phrase.
16 |
You can toggle this preference on at the bottom of Ghost's General Settings
17 |
18 |
Ghost will give you a short, randomly generated pass-phrase which you can share with anyone who needs access to the site while you're working on it. While this setting is enabled, all search engine optimisation features will be switched off to help keep the site off the radar.
19 |
Do remember though, this is not secure authentication. You shouldn't rely on this feature for protecting important private data. It's just a simple, shared pass-phrase for very basic privacy.
Ghost uses a language called Markdown to format text.
15 |
When you go to edit a post and see special characters and colours intertwined between the words, those are Markdown shortcuts which tell Ghost what to do with the words in your document. The biggest benefit of Markdown is that you can quickly apply formatting as you type, without needing to pause.
16 |
At the bottom of the editor, you'll find a toolbar with basic formatting options to help you get started as easily as possible. You'll also notice that there's a ? icon, which contains more advanced shortcuts.
17 |
For now, though, let's run you through some of the basics. You'll want to make sure you're editing this post in order to see all the Markdown we've used.
18 |
Formatting text
19 |
The most common shortcuts are of course, bold text, italic text, and hyperlinks. These generally make up the bulk of any document. You can type the characters out, but you can also use keyboard shortcuts.
20 |
21 |
CMD/Ctrl + B for Bold
22 |
CMD/Ctrl + I for Italic
23 |
CMD/Ctrl + K for a Link
24 |
CMD/Ctrl + H for a Heading (Press multiple times for h2/h3/h4/etc)
25 |
26 |
With just a couple of extra characters here and there, you're well on your way to creating a beautifully formatted story.
27 |
Inserting images
28 |
Images in Markdown look just the same as links, except they're prefixed with an exclamation mark, like this:
29 |
30 |
31 |
Most Markdown editors don't make you type this out, though. In Ghost you can click on the image icon in the toolbar at the bottom of the editor, or you can just click and drag an image from your desktop directly into the editor. Both will upload the image for you and generate the appropriate Markdown.
32 |
Important Note: Ghost does not currently have automatic image resizing, so it's always a good idea to make sure your images aren't gigantic files before uploading them to Ghost.
33 |
Making lists
34 |
Lists in HTML are a formatting nightmare, but in Markdown they become an absolute breeze with just a couple of characters and a bit of smart automation. For numbered lists, just write out the numbers. For bullet lists, just use * or - or +. Like this:
35 |
36 |
Crack the eggs over a bowl
37 |
Whisk them together
38 |
Make an omellete
39 |
40 |
or
41 |
42 |
Remember to buy milk
43 |
Feed the cat
44 |
Come up with idea for next story
45 |
46 |
Adding quotes
47 |
When you want to pull out a particularly good except in the middle of a piece, you can use > at the beginning of a paragraph to turn it into a Blockquote. You might've seen this formatting before in email clients.
48 |
49 |
A well placed quote guides a reader through a story, helping them to understand the most important points being made
50 |
51 |
All themes handles blockquotes slightly differently. Sometimes they'll look better kept shorter, while other times you can quote fairly hefty amounts of text and get away with it. Generally, the safest option is to use blockquotes sparingly.
52 |
Dividing things up
53 |
If you're writing a piece in parts and you just feel like you need to divide a couple of sections distinctly from each other, a horizontal rule might be just what you need. Dropping --- on a new line will create a sleak divider, anywhere you want it.
54 |
55 |
This should get you going with the vast majority of what you need to do in the editor, but if you're still curious about more advanced tips then check out the Advanced Markdown Guide - or if you'd rather learn about how Ghost taxononomies work, we've got a overview of how to use Ghost tags.
Creating a totally custom design for your publication
15 |
Ghost comes with a beautiful default theme called Casper, which is designed to be a clean, readable publication layout and can be easily adapted for most purposes. However, Ghost can also be completely themed to suit your needs. Rather than just giving you a few basic settings which act as a poor proxy for code, we just let you write code.
16 |
There are a huge range of both free and premium pre-built themes which you can get from the Ghost Theme Marketplace, or you can simply create your own from scratch.
17 |
18 |
19 |
Anyone can write a completely custom Ghost theme, with just some solid knowledge of HTML and CSS
20 |
21 |
Ghost themes are written with a templating language called handlebars, which has a bunch of dynamic helpers to insert your data into template files. Like {{author.name}}, for example, outputs the name of the current author.
22 |
The best way to learn how to write your own Ghost theme is to have a look at the source code for Casper, which is heavily commented and should give you a sense of how everything fits together.
23 |
24 |
default.hbs is the main template file, all contexts will load inside this file unless specifically told to use a different template.
25 |
post.hbs is the file used in the context of viewing a post.
26 |
index.hbs is the file used in the context of viewing the home page.
If you want to chat with other people making Ghost themes to get any advice or help, there's also a #themes channel in our public Slack community which we always recommend joining!
Ghost has a single, powerful organisational taxonomy, called tags.
16 |
It doesn't matter whether you want to call them categories, tags, boxes, or anything else. You can think of Ghost tags a lot like Gmail labels. By tagging posts with one or more keyword, you can organise articles into buckets of related content.
17 |
Basic tagging
18 |
When you write a post, you can assign tags to help differentiate between categories of content. For example, you might tag some posts with News and other posts with Cycling, which would create two distinct categories of content listed on /tag/news/ and /tag/cycling/, respectively.
19 |
If you tag a post with both NewsandCycling - then it appears in both sections.
20 |
Tag archives are like dedicated home-pages for each category of content that you have. They have their own pages, their own RSS feeds, and can support their own cover images and meta data.
21 |
The primary tag
22 |
Inside the Ghost editor, you can drag and drop tags into a specific order. The first tag in the list is always given the most importance, and some themes will only display the primary tag (the first tag in the list) by default. So you can add the most important tag which you want to show up in your theme, but also add a bunch of related tags which are less important.
23 |
News, Cycling, Bart Stevens, Extreme Sports
24 |
In this example, News is the primary tag which will be displayed by the theme, but the post will also still receive all the other tags, and show up in their respective archives.
25 |
Private tags
26 |
Sometimes you may want to assign a post a specific tag, but you don't necessarily want that tag appearing in the theme or creating an archive page. In Ghost, hashtags are private and can be used for special styling.
27 |
For example, if you sometimes publish posts with video content - you might want your theme to adapt and get rid of the sidebar for these posts, to give more space for an embedded video to fill the screen. In this case, you could use private tags to tell your theme what to do.
28 |
News, Cycling, #video
29 |
Here, the theme would assign the post publicly displayed tags of News, and Cycling - but it would also keep a private record of the post being tagged with #video.
30 |
In your theme, you could then look for private tags conditionally and give them special formatting:
31 | {% raw %}
32 |
{{#post}}
33 | {{#has tag="#video"}}
34 | ...markup for a nice big video post layout...
35 | {{else}}
36 | ...regular markup for a post...
37 | {{/has}}
38 | {{/post}}
39 |
40 |
You can find documentation for theme development techniques like this and many more over on Ghost's extensive theme documentation.
