pages-themes / cayman Goto Github PK
View Code? Open in Web Editor NEWCayman is a Jekyll theme for GitHub Pages
Home Page: https://pages-themes.github.io/cayman/
License: Creative Commons Zero v1.0 Universal
Cayman is a Jekyll theme for GitHub Pages
Home Page: https://pages-themes.github.io/cayman/
License: Creative Commons Zero v1.0 Universal
Would be a good addition to the overall theme
It would be nice to have some ready-to-use social buttons and about page by default.
Hello and thanks for making this,
I like to run jekyll with:
liquid:
error_mode : strict
strict_filters : true
strict_variables : true
This is for some basic sanity, I'd rather that my site doesn't build than have unknown errors.
But it seems to be giving me trouble:
Configuration file: /home/luke/git/____/source/_config.yml
Invalid theme folder: _includes
Source: .
Destination: ../docs
Incremental build: disabled. Enable with --incremental
Generating...
Liquid Exception: Liquid error (line 6): undefined variable paginator in /_layouts/default.html
bundler: failed to load command: jekyll (/home/luke/gems/bin/jekyll)
Liquid::UndefinedVariable: Liquid error (line 6): undefined variable paginator
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:192:in `lookup_and_evaluate'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:173:in `block in find_variable'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:172:in `each'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:172:in `find_variable'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/variable_lookup.rb:36:in `evaluate'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:159:in `evaluate'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/context.rb:151:in `[]'
/home/luke/gems/gems/jekyll-seo-tag-2.5.0/lib/jekyll-seo-tag.rb:52:in `payload'
/home/luke/gems/gems/jekyll-seo-tag-2.5.0/lib/jekyll-seo-tag.rb:36:in `render'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/block_body.rb:109:in `render_node'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/block_body.rb:88:in `block in render'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/block_body.rb:75:in `each'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/block_body.rb:75:in `render'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/template.rb:208:in `block in render'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/template.rb:242:in `with_profiling'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/template.rb:207:in `render'
/home/luke/gems/gems/liquid-4.0.0/lib/liquid/template.rb:220:in `render!'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/liquid_renderer/file.rb:30:in `block (2 levels) in render!'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/liquid_renderer/file.rb:42:in `measure_bytes'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/liquid_renderer/file.rb:29:in `block in render!'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/liquid_renderer/file.rb:49:in `measure_time'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/liquid_renderer/file.rb:28:in `render!'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/renderer.rb:126:in `render_liquid'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/renderer.rb:195:in `render_layout'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/renderer.rb:158:in `place_in_layouts'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/renderer.rb:88:in `render_document'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/renderer.rb:62:in `run'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:479:in `render_regenerated'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:472:in `block in render_pages'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:471:in `each'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:471:in `render_pages'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:192:in `render'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/site.rb:71:in `process'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/command.rb:28:in `process_site'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/build.rb:65:in `build'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/build.rb:36:in `process'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/serve.rb:93:in `block in start'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/serve.rb:93:in `each'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/serve.rb:93:in `start'
/home/luke/gems/gems/jekyll-3.8.5/lib/jekyll/commands/serve.rb:75:in `block (2 levels) in init_with_program'
/home/luke/gems/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `block in execute'
/home/luke/gems/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `each'
/home/luke/gems/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `execute'
/home/luke/gems/gems/mercenary-0.3.6/lib/mercenary/program.rb:42:in `go'
/home/luke/gems/gems/mercenary-0.3.6/lib/mercenary.rb:19:in `program'
/home/luke/gems/gems/jekyll-3.8.5/exe/jekyll:15:in `<top (required)>'
/home/luke/gems/bin/jekyll:23:in `load'
/home/luke/gems/bin/jekyll:23:in `<top (required)>'
The terminal process terminated with exit code: 1
Relevant _config
:
# theme vars
lang: en
paginator: 10
At first it complained about lang
undefined, and adding it to _config
fixed that, but the paginator
error doesn't seem to want to go away.
Am I doing something wrong?
I'm kinda new to github, I'm trying to make a webpage at rastamanjohn.github.io. I saw in the README.md i can add a analytics tracking ID in the _config.yml, but I imagine that I shouldn't push the file with my ID. So how do I have it on my page without making it available to everyone?
I'm trying to override the color variables as described in the readme but it is not working. Anyone else having issues?
Here is my assets/css/style.scss
$header-bg-color: #6E4D9B;
$header-bg-color-secondary: #E82887;
$section-headings-color: #6E4D9B;
@import "{{ site.theme }}";
Since most sites use favicons including them in if available would be a good idea
The back link on the another-page.md file does not work.
https://github.com/pages-themes/cayman/blob/master/another-page.md
I really love this theme and thinking how to take it to the next level I had an idea:
Would be great if in large layout (maybe no needed for the mobile one) big sections (# in markdown) could be load as a cards. I think is a nice mode of make this theme more "natural" and useful in big screens.
In mobile it just load 1sr #, then 2nd and so on (like now). On large mode instead of loading normal it will create something like this:
I think it could be just an option and I don't know if it is difficult to implement.
I not an expert, for this reason I upload this, but I can contribute if more people try to do this
Hi guys, I have an issue rendering the table of content of the readme which is wrapped inside a collapasble panel (<details></details>
). The readme contains:
<details>
<summary>Table of contents</summary>
- [Introduction](#introduction)
- [Cloud Computing Reference Model](#cloud-computing-reference-model)
- [Data centers](#data-centers)
...
</details>
Which in the readme is displayed as
Other lists outside details tag are properly converted to <ol>
and <li>
elements. Any suggestions on how to fix this? Thanks!
Hi,
I'm new to Jekyll & Github Pages so I'm probably missing something obvious here but I cannot find what.
style.css is loaded in default.html via
<link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
So on Github Pages hosting, the url for this stylesheet is https://alexpoint.github.io/assets/css/style.css?v=33125130a4821c5cff85754a283fd242618965dd
and it's actual location is
https://alexpoint.github.io/remedes/assets/css/style.css?v=33125130a4821c5cff85754a283fd242618965dd
Any idea what I'm missing here to have the name of the repository included in the URL?
Thanks
I recently published a repo of mine, BigInt, as a GitHub pages site using the Cayman theme, but the code blocks marked as 'C++', like:
```C++
// some C++ code here...
```
do not get syntax highlighted. On inspecting the generated HTML, I see that the class language-C++
is added on the <code>
elements, but there's no syntax highlighting on them.
The is no description in d2f951c as to why the gtag
Google analytics code was reverted. Could you, please, clarify?
I have created a custom CSS as described in documentation. File 'style.css' is placed at /assets/css/style.css:
https://github.com/vorov2/slot/edit/master/assets/css/style.css
However, styles from CSS are ignored.
How do you disable the view on github button for your github page. Putting github:
is_project_page: false in _config.yml doesn't work. Please help!!
As seen on Leap Day.
I prefer this theme visually, but the on-this-page TOC is a nice touch.
When I use this theme via settings>GitHub pages themes for a repo, default title is taken as the repo name and description as repo description.
I have created an index.md file with front matter including 'title' and 'description'. But it doesn't seem to work. Is there a workaround or is it normal behavior?
Your theme has been listed on http://jekyllthemes.ru/
The original theme is licensed under CC-BY 4.0. You don't have the authority to release it into the public domain. Please change it back. ๐
Also, without attribution to the original author (Jason Long), this is copyright infringement.
I've tried a bunch of different _config.ymls but nothing's making it hide.
The button is pointless since the repo for my site is private as I occasionally throw files onto it to share but I don't want them on my profile.
in the same line with "View Github" button
I have a live website using cayman theme.
I wanted to know if its possible to reduce the height of the default theme header that has the green gradient header(in original theme). If yes then how do I go about doing it?
Hi :)
It would be nice if the hard-coded meta tag "theme-color" is changed with a variable, I'd love to do it myself and send my PR, but I'm learning Ruby and I don't know if what I'm asking is even possible, but it would be nice since I've been looking for that value like 10 times on each CSS file.
Thanks
Are there plans to provide table of contents support?
This can be done easily via https://github.com/allejo/jekyll-toc but would need to have aligned styling.
Either opt-in or opt-out would be fine.
In my GitHub organization (https://github.com/open-dis), I've got a repository dedicated to hosting the content for our website (https://github.com/open-dis/open-dis.org) and we're using this Jekyll Cayman theme. The problem is the "View on GitHub" link that is generated directs people to the repository for the website content, which is not really useful. Instead if the button linked to the top level GitHub organisation page (e.g. https://github.com/open-dis) it'd be more useful so that the user could browse the repos the organisation offers.
I get that the current behaviour works if someone were publishing their web site under the gh-pages
branch. But for standalone website repositories I think the behaviour of the button could be better as mentioned above.
Sorry I am new.
How do I remove View on GitHub button? And how do I remove in footer miakurt is maintained by miakurt.
This page was generated by GitHub Pages.
And how do I publish my page? Thank you.
I just choose cayman theme on github setting. I already designed a logo (favicon) for my webpage, where should I put it?
Thanks!
In the default layout the description meta tag is included twice.
First through the SEO plugin:
{% seo %}
Second hard coded in the head tag itself:
<meta name="description" content="{{ page.description | default: site.description | default: site.github.project_tagline }}"/>
This is duplicate information and causes the W3C HTML validator to generate a warning about it.
is there any way to place a logo instead of the title? would be great, thanks;)
I can't add an image to my GitHub page, I am using the following markdown command:
![](https://github.com/amir-saadat/link/to/my/image.png)
The image is replaced with question marks. please see the page
please help. thanks.
I work with another team that publishes a Cayman-themed "releases" page that now has hundreds of items (of several lines each) in 5 general categories.
tl;dr
: Deep-linking is essential for us.
When I want to send a reader to a particular item, adding the normal #fragment
to the page URL has no effect (in Chrome, Fifefox, Safari).
The id
tags are there in the page, but the sections don't open up when the fragment is supplied. (In case there's any doubt, once I manually open the correct section, browsers will position appropriately after I add the #fragment
in the address bar.)
This means I have to add text โ around each link โ telling readers which section to click on, and then what to search for.
This makes every mention unnecessarily long, and looks like one of us (me or the team publishing the page) doesn't know how to do HTML right.
I scanned thru the repo, but couldn't see any way to have the target of the #fragment
be opened without user action. I hope it's there (a query param?) and I'm just not seeing it.
I am using gh-pages to generate a web page for my repo (mostly markdown files). Is there an easy way I can edit the syntax highlighting theme using _config.yml file?
Hey there,
I am quite confused by having to ask this here, but: I don't seem able to enable the Google Analytics tag of the Cayman theme. ๐
According to the read me, the only thing to do is setting google_analytics
in the _config.yml
and even the if-clause in the layout file looks like this should be working.
However, after adding the tracking ID, the corresponding GH-page still does not render the analytics tag ๐ค
Here is the link to the repository: https://github.com/jeakfrw/jeakfrw.github.io
Thank you in advance
Code in /assets/css/style.scss
@import "{{ site.theme }}";
.page-header {
background-image: linear-gradient(135deg, #6C67E7, #6FB4E6);
}
Code in '_layouts/default.html`
<!DOCTYPE html>
<html lang="{{ site.lang | default: "en-US" }}">
<head>
<meta charset="UTF-8">
{% seo %}
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#157878">
<link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
</head>
<body>
<section class="page-header">
<h1 class="project-name">{{ site.title | default: site.github.repository_name }}</h1>
<h2 class="project-tagline">{{ site.description | default: site.github.project_tagline }}</h2>
</section>
<section class="main-content">
{{ content }}
</section>
</body>
</html>
I'm expecting the color of the linear-gradient
in .page-header
to change color but it isn't.
Google Analytics suggests upgrading to analytics.js for all users. Had this changed for my page layout and tested ok.
Would you like a pull request for this change?
I want to have complete control of the styling, but I want to base it off Cayman, so how can I import the styling code from here into my own repository, then set the repository to load that style instead?
Hi there, I'm using a table like this in my readme
:
Flag | Code |Region
:---: | :---: | :---
![AD](png/EU.png) | EU | European Union
![AE](png/WW.png) | WW | World
![CNA](png/CNA.png) | CNA | North America
![CSA](png/CSA.png) | CSA | South America
In the repository it seems to render correctly, however, in the page it does not. Am I doing something wrong? ๐
I got this warning from bundle install (I am not a ruby dev)
Post-install message from sass:
Ruby Sass is deprecated and will be unmaintained as of 26 March 2019.
If you use Sass as a command-line tool, we recommend using Dart Sass, the new
primary implementation: https://sass-lang.com/install
If you use Sass as a plug-in for a Ruby web framework, we recommend using the
sassc gem: https://github.com/sass/sassc-ruby#readme
For more details, please refer to the Sass blog:
http://sass.logdown.com/posts/7081811
For example, in the _config.yml, if you enter download_loc: <branch>
, the directory of the location will change to [repository URL]/zipball/[branch]
The README documentation mentions using assets/css/style.scss
to add custom CSS. I've used this to successfully in a GitHub Pages organization site to override some theme styles, such as body font-family and .main-content padding.
It is not clear to me how to override the color variables defined in _sass/variables.scss
though.
Please accept my apologies in advance as this is more a question and less an issue.
Hi there!
So i have a problem where on my gitHub page there is no download buttons.
I tried changing the theme, and same thing happens. So this is not a specific theme issue, this is issue of all themes
Hello there, I'm facing a problem with tables rendering, this is my code:
| Flag | Code | Region |
|:--------------------|:-----|:---------------|
| ![AD](png/EU.png) | EU | European Union |
| ![AE](png/WW.png) | WW | World |
| ![CNA](png/CNA.png) | CNA | North America |
| ![CSA](png/CSA.png) | CSA | South America |
| ![CEU](png/CEU.png) | CEU | Europe |
| ![CAF](png/CAF.png) | CAF | Africa |
| ![CAS](png/CAS.png) | CAS | Asia |
| ![COC](png/COC.png) | COC | Oceania |
and it looks like:
However in readme.md
is rendering correctly:
This is my live site to check it out.
The official guide says that to change the layout, copy https://github.com/pages-themes/cayman/blob/master/_layouts/default.html and save it locally. However this way, user has to keep all future changes up to date. For example, if I get the current master of this file, there is a "skip-to-content" link from #43, which is visible because the CSS is not updated (it is still 0.1.1). If I got the 0.1.1 version of the default layout, I won't benefit future updates, like this skip-to-content link.
Is there a better way to "extend" a layout? Or maybe make it more extensible. E.g. with the current layout, there's no way to change to site-footer-credits section without forking the layout.
I want to disable the "View on GitHub" button from my site, as the source code is currently in a private repository. Is there a setting for _config.yml that the it will do it?
The theme was made compatible with Jekyll 4.0 a while ago, but no release has been made since then, so it's not available through RubyGems. Could that be rectified?
It looks like if I am setting up GH pages with one of their default themes I do not get the latest HTML/CSS. What am I missing?
How come HTML structure looks like this?:
<body>
<section class="page-header">
</section>
<section class="main-content">
</section>
</body>
And not like this?:
<body cz-shortcut-listen="true">
<a id="skip-to-content" href="#content">Skip to the content.</a>
<header class="page-header" role="banner">
</header>
<main id="content" class="main-content" role="main">
</main>
</body>
According to the latest default
template of cayman it should use header
, main
and have a scip to content link.
I created this test repo to describe my issue: https://github.com/escapedcat/github-pages-test
This is not a specific problem of the cayman theme. I have the same problem with other default themes. I just didn't know where exactly to raise this issue/question.
Please let me know if I should move this to somewhere else.
The user @carlsonsantana validate your site template "https://pages-themes.github.io/cayman/" and found these accessibility errors:
#content > div:nth-child(11) > div > pre > code > span:nth-child(4)
<span class="no">Dependencies</span>
#content > div:nth-child(11) > div > pre > code > span:nth-child(2)
<span class="no">GitHubPages</span>
#content > div:nth-child(11) > div > pre > code > span:nth-child(1)
<span class="c1"># Ruby code with syntax highlig...</span>
#content > div:nth-child(10) > div > pre > code > span:nth-child(1)
<span class="c1">// Javascript code with syntax ...</span>
html > body > header > a:nth-child(5)
<a href="https://github.com/pages-themes/cayman/tarball/master" class="btn">Download .tar.gz</a>
html > body > header > a:nth-child(4)
<a href="https://github.com/pages-themes/cayman/zipball/master" class="btn">Download .zip</a>
html > body > header > a:nth-child(3)
<a href="https://github.com/pages-themes/cayman" class="btn">View on GitHub</a>
You can check these accessibility errors using pa11y.
You can view the full validation results in our website.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.