fongandrew / hydeout Goto Github PK
View Code? Open in Web Editor NEWA refreshed version of Hyde for Jekyll 3.x and 4.x
Home Page: https://fongandrew.github.io/hydeout/
License: Other
A refreshed version of Hyde for Jekyll 3.x and 4.x
Home Page: https://fongandrew.github.io/hydeout/
License: Other
To successfully install this theme with Github pages, I needed to not only add
gem "jekyll-theme-hydeout", "~> 3.4"
to Gemfile
, but also needed to add
'remote_theme: fongandrew/hydeout' to the _config.yml
.
Just adding gem 'github-pages', group: :jekyll_plugins
to the Gemfile didn't do it. Also, only having the 'remote_theme' specification in _config.yml
didn't do it either.
This might be obvious to more experienced Jekyll users; I know that it would have saved me a lot of time to have had that note there.
I just wanted to reach the maintainers of this repository, because, after three years reading code of different Jekyll Theme contributions related to Jekyll, I think this is one of the most beautiful repositories I've seen so far. Very maintainable, clean and readable code. I always want to achieve code like this for my personal web projects, even being an Android Dev, I can appreciate this repo as a piece of art!
Thank you so much for a great job!
Following the usage / installation instructions on README didn't work, resulting in version errors.
I had to use this in gemfile instead, maybe you missed this doc update in your commit?
gem "jekyll-theme-hydeout", "~> 4.1"
I was running jekyll locally with with docker, and was able to use the hydeout layout. However the new layout fails to build on Github.
The page build failed for the `master` branch with the following error:
The hydeout theme is not currently supported on GitHub Pages. For more information, see https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/.
For information on troubleshooting Jekyll see:
https://help.github.com/articles/troubleshooting-jekyll-builds
If you have any questions you can contact us by replying to this email.
My current _config.yml
file is:
remote_theme: fongandrew/hydeout
# Setup
title: 'Jose Antunes'
tagline: 'Code, Food, Travel'
description: 'Everyday learning and sharing'
url: https://joseantunes.tech
baseurl: ''
# the optional subpath of your site, e.g. "/blog"
# NB: This applies to all pages in your Jekyll site.
# If you want to move just the blog index pages but keep
# other pages at root, see the paginate_path and
# sidebar_blog_link below.
author:
name: 'Jose Antunes'
url: https://linkedin.com/in/antunesjose
paginate: 5
github:
repo: https://github.com/theholy7
and my Gemfile
is:
source 'https://rubygems.org'
gem "github-pages", group: :jekyll_plugins
gem "jekyll-theme-hydeout", "~> 3.4"
I don't know where to search, as I think I have done things correctly. If you could help me, I'd be very thankful.
Best,
Jose
I tried the Google search on demo site, it always show
Your search - xxxxxxx site:fongandrew.github.io/hydeout/hydeout - did not match any documents.
Is this a bug or something won't work with demo?
What I need to do so that post under _post folder appear on the Home page? I also tried locally but couldn't get it working.
Here is the link: https://pchaturv.github.io/Praveen/
I would highly appreciate any response.
Thanks
This is probably documented somewhere but I swear I can't figure this out for the life of me. I'm trying to remove the base url of /hydeout so that everything can just be displayed on the root or '/' but everytime I do the styling is broken and when I go to the root of my url it gives me a 404 error. how do remove the usage of baseurl or not get a 404 on root
markdown: kramdown
highlighter: rouge
# Setup
title: 'Welcome'
tagline: 'games n stuff'
description: '<a href="https://lightfoot.cloud" target="_blank">Lightfoot Cloud</a>, felt cute might delete.'
url: "https://daniel.lightfoot.cloud"
baseurl: '/hydeout'
# the optional subpath of your site, e.g. "/blog"
# NB: This applies to all pages in your Jekyll site.
# If you want to move just the blog index pages but keep
# other pages at root, see the paginate_path and
# sidebar_blog_link below.
contact: [email protected]
author:
name: 'Daniel Lightfoot'
url: https://twitter.com/dadhatdaniel
paginate: 5
paginate_path: '/page:num'
# Or '/blog/page:num' if you want to move your index pages
plugins:
- jekyll-feed
- jekyll-gist
- jekyll-paginate
# Sidebar link settings
sidebar_home_link: false
# sidebar_blog_link: '/blog' # By default, your home page is your blog
# page. If you change your paginate_path,
# set this to the root of the paginate_path
# to enable a separate blog link.```
I get this warning every time I start bundle exec jekyll serve
. Everything seems to work fine, but I thought I should probably bring this to your attention.
https://janxspirit42.github.io/
The site is just generating in plain text, I have taken a look at the other issues and added lines to Gemfile and _config.yml to no avail. Any ideas?
https://github.com/JanxSpirit42/janxspirit42.github.io
edit: typo
Hi Andrew. I really like this theme, but we're facing an issue where the menu can't decide what to do when the browser window is at intermediate sizes (close to the top/side menu transition). I noticed it does it on your hydeout theme demo site as well, and so this is a general issue. I took a screen video of it, but can't add to the GitHub issue. I can email the video, or you can just open your demo site. Bring the window width across, and hover the pointer over the site. It occur at a relative broad range of window widths, and so possible something about the menu transition settings in css.
hi, when category has space as "edge case" URL became "edge%20case". how to convert it to "edge-case". i find a "post.rb" plugin but don not know how to use. i also some special char such as "İÜŞÖı" and want to convert "IUSOı" at link. Can you show a way how to do this.
thanks.
I find the default colours hard to read, but I'm not sure if there's an easy way to switch to some other syntax highlighting theme.
I find the font size on the posts to be very large. I tried to make it smaller by editing main.scss to:
---
# Use a comment to ensure Jekyll reads the file to be transformed into CSS later
# only main files contain this front matter, not partials.
---
$code-color: #202020;
$root-font-size: 0.5rem;
@import "hydeout";
but this did not change the font size.
I'm getting the following message:
"Your site is having problems building: A file was included in /_layouts/post.html that is a symlink or does not exist in your _includes directory. For more information, see https://docs.github.com/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites#file-is-a-symlink."
But it appears that all of the files referenced in post.html are in my _includes folder...confused!
Hi,
I would like to know whether the theme configuration allows having a short introduction to the article being shown with Read more
button which leads to the whole artickle?
Thank you
Steps to reproduce:
When jemoji
is enabled emojis are always displayed on a line by themselves. You can see https://emacsredux.com/blog/2018/09/29/super-save-0-dot-3/ as an example.
This works just fine with some other them - e.g. minima.
Trying to work with the jekyll-archives gem and trying to build a layout. It isn't working currently: nothing is displayed in the archive page. I haven't pushed this to my repo.
My current archive page layout is;
---
layout: default
---
<!DOCTYPE html>
<html lang="en">
<body>
<header>
<h1 class="page-title">{{ page.title }}</h1>
</header>
<div class="content">
<h1>Archive of posts from {{ page.date | date: "%Y" }}</h1>
<ul class="posts-lists">
{% for post in page.posts %}
<li>
<span class="post-meta">{{ post.date | date: "%b %-d, %Y" }}</span>
<a class="post" href="{{ post.url | prepend: site.baseurl }}">{{ post.title }}</a>
</li>
{% endfor %}
</ul>
</div>
</html>
The page in dev:
Can you help me out or implement this is some way into Hydeout?
I have disqus configured in my blog hosted as GitHub Pages with custom domain. I provided shortname which is krzysztof_madej
. When I click load comments page send this request:
On disqus side I have page configured with:
https://thecodemanual.pl
thecodemanual.pl
and kmadof.github.io
I guess that this is me doing sth wrong, but I really have no idea how to fix it. Or maybe do you have the same issue?
Hi,
I'm trying to make a multilingual version of Hydeout (such a gorgeous theme btw):
https://github.com/azarrias/hydeout-multilingual
There is one thing that I really have no clue on how to make it multilingual, and it is the RSS feed.
I wonder if you could give some ideas on how to make that happen.
I don't want to use any plugin, since I want to use this straight on github pages.
Thanks a lot!
Kind regards
hi, i try hydeout and add some images in but links broken. what is the right way to link to image.
i tried as link text
If I have wide tables in some posts and I try to read them on narrow display devices (in mobile view - like on the phone) I get reversed colors when scrolling to see the part of the table that doesn't fit to the screen.
Example of a post:
---
layout: post
title: Table
---
|1|1|2,584|6,000|36,85|7,000|83,78|0,00|6,10|10,15|136,93|31,19|3,16|7,11|0,13|0,42|315,82|
|1|1|2,584|6,000|36,85|7,000|83,78|0,00|6,10|10,15|136,93|31,19|3,16|7,11|0,13|0,42|315,82|`
for which I get this screen when scrolling to the right.
Any clues as to what should I change in _layout.css?
I couldn't figure out how to only show excerpts in the index page. Do I need to manually create excerpts on each post, or would it be possible for the theme to automatically use the first paragraph as excerpts?
Hey everyone,
I have just forked the hydeout and changed small things to force rebuild. However, it does not look like theme is built.
I have also added the remote theme command to config. Can anyone guess why?
I have a question about how to go about implementing a kind of multiple blog like site.
My requirement is that I want to have three sections in the sidebar. One that is home, then two more sections (section A, section B).
I want the home section to be all posts from both section A and B and then I want section A and B to have posts of their own all listed like the home page including the pagination but only posts in section A will obviously be in section A and the same for section B. Again the home section would be a collection of both A and B posts.
Is this possible in the current implementation? If so could you maybe point me to an example or even in the right direction?
Thanks a lot.
Having:
github:
repo: "<repo_url>"
in the _config.yml
file prevents the page from building successfully.
Also the theme is not correctly using (or doesn't allow the user to select) the Github Pages Metadata.
For example, in the sidebar HTML file, we have site.github.repo
rather than site.github.repository_url
.
We've created a quick start button for the Hydeout theme including CMS configuration for Forestry (https://github.com/forestryio/hydeout-jekyll-starter). This link imports the starter repo into the user's account and sets it up in Forestry with instructions on how to deploy the site with Netlify and other providers.
I think the import button makes it a lot easier to get started quickly and better understand the different parts of the JAMStack.
How would you feel about adding the import button as an option to the theme's Readme file? (Examples: https://github.com/daviddarnes/alembic, https://github.com/spf13/hyde)
Curious to hear what you think.
When loading pages in hydeout the sidebar has the focus instead of the main section. Something that disables the ability to just press page down/page up to scroll the documents. I guess the sensible default should be (as in Hyde) to scroll the posts?
I maintain a small blog and the screen is effectively cut in half on a 4k screen, with the right half being whitespace.
While I know there are a lot of good visual reasons for this, most of my blog entries contain large code samples, requiring the pre/code boxes to scroll at the current width in most cases.
What I have done is fork it over at https://github.com/erikh/hydeout and added a single commit to add the max-width to 76rem in the large media layout, but I assume you will want to make it configurable instead, so I did not submit as a pull request. I am not that familiar with this stack.
Hope this is useful commentary, the result looks nicer I think:
The original:
I have commented out baseurl
in _config.yml, but when I click site.baseurl
in 404.html, the browser doesn't navigate to the baseurl
, instead of the current location.
$ bundle exec jekyll serve
Dependency Error: Yikes! It looks like you don't have jekyll-seo-tag or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-seo-tag' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
jekyll 3.8.3 | Error: jekyll-seo-tag
Very nice theme! When I change _config.yml
to include paginate_path: '/blog/page:num'
and sidebar_blog_link: '/blog'
as suggested by your helpful comments, I get a 'Blog' page in the side bar as desired. However, this page (or rather: the folder _site/blog
) lacks an index.html
.
For testing, I manually copied the index.html
from _site
to _site/blog
and the blog looked fine (clicking 'older' at the bottom of the first page correctly linked to the 2nd page of the blog). Might I kindly ask for your help to do this programmatically?
I put tracking tag at google-analytics property in config.yml
But, I can't get any results in google analytics report page.
So I checked my setting with Tag Assistant Legacy (by Google), it says that this is not proper setting.
Hello,
Is it possible to have a similar, dynamic index filter for categories as the for tags?
https://fongandrew.github.io/hydeout/tags
Thanks! k
The theme has a back arrow at the top of pages. E.g., on the about page.
This back arrow link does not link back to the home page, but just refreshes the page.
Should we remove it? How?
I would like to specify the color of the #sidebar .site-title css property.
Can we add a variable for customization?
Ran into some trouble using the disqus.html file as-is. Seems like Disqus does not allow relative URLs anymore (some old documentation has it), which is what the theme uses (via page/site variables).
I love this fork. Thanks for working on it.
I was wondering if you could incorporate Open Graph and Twitter Cards into the theme? If not, could you perhaps suggest some gems I could use?
Thanks!
So, I tried to install the theme to a new Jekyll website, and couldn't see any of the posts
How to reproduce:
jekyll new myblog
github-pages
and jekyll-remote-theme
gemsbundle
remote_theme: fongandrew/hydeout
to _config.yml
jekyll serve
Spent quite a lot of time to get things working. Turns out, my _config.yml
was missing a line:
paginate: 5
Adding the config solves the problem:
Didn't see it anywhere in the docs, so I've created the issue
I have been using Hyde for a few years and really like it, so was very happy to see that someone has taken up the theme! I do have some problems with it though and one is related to the reverse-layout. When I am using that in hydeout the scrollbar is located between the sidebar and the main section. In original Hyde the scroll bar is located all the way to the right, which looks much tidier. Or am I missing a customization option somewhere?
The theme is great and I appreciate the work behind it. I'm trying to use it for some math lecture notes, and I found a bug with how MathJax displays equations. Here's a screenshot of the problem:
I've attached a minimal site that produces the result. It just has an include for the MathJax script header and a single MD page that produces a few equations. Should be able to serve it and view test.html to see the problem:
I'm 95% confident it's a bad CSS interaction; the MXJc-display enclosing element has zero height, which is not what I see on other MathJax content I've generated. But I'm out of my depth trying to pinpoint the problem.
Let me start out by saying thank you so much for taking in this project and maintaining it! It was a huge bummer when I tired the original Hyde and it didn't work. Glad I found this project 😃
I noticed in the demo site when a post was very long it still put the entire thing in the home page even though it was limited to 5 posts. I think it would be great if posts truncated after a certain length and had a Read More... button when displayed in the home page. Keeping the home page at a reasonable length and drawing people into the post page where they can comment, etc,
Thoughts?
Hey, nice theme!
Could it be possible to implement a way to configure the order the elements appear in the sidebar? They seem to be currently sorted by name, which might be impractical in some cases. Some order
parameter in the Front Matter block would be enough.
The user @carlsonsantana validate your site template "https://fongandrew.github.io/hydeout/" and found these accessibility errors:
html > body > main > div > div > a
<a class="pagination-item older" href="/hydeout/page2"> Older </a>
html > body > main > div > article:nth-child(5) > a
<a href="/hydeout/2012/02/05/markup-syntax-highlighting.html">More …</a>
html > body > main > div > article:nth-child(4) > p:nth-child(6) > a
<a href="https://github.com/mojombo/jekyll">visiting the project on GitHub</a>
html > body > main > div > article:nth-child(4) > blockquote > p
<p>Jekyll is a simple, blog aware,...</p>
html > body > main > div > article:nth-child(4) > p:nth-child(3) > a:nth-child(2)
<a href="https://github.com/mojombo/jekyll/blob/master/README.markdown">the project’s readme</a>
html > body > main > div > article:nth-child(4) > p:nth-child(3) > a:nth-child(1)
<a href="http://jekyllrb.com">Jekyll</a>
html > body > main > div > article:nth-child(3) > p:nth-child(39) > a
<a href="https://github.com/poole/poole/issues/new">Open an issue.</a>
#readme > article > p:nth-child(3) > code:nth-child(4)
<code>%}</code>
#readme > article > p:nth-child(3) > code:nth-child(3)
<code>{%</code>
#readme > article > p:nth-child(3) > code:nth-child(2)
<code>gist</code>
#readme > article > p:nth-child(3) > code:nth-child(1)
<code>5555251</code>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(22)
<span class="c1">// > 8</span>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(20)
<span class="mi">6</span>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(18)
<span class="mi">2</span>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(15)
<span class="c1">// Call the function </span>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(2)
<span class="c1">// Create a function that takes...</span>
html > body > main > div > article:nth-child(3) > figure > pre > code > span:nth-child(1)
<span class="c1">// Example can be run directly ...</span>
html > body > main > div > article:nth-child(3) > p:nth-child(14) > code
<code class="highlighter-rouge">code element</code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(6) > code:nth-child(4)
<code class="highlighter-rouge"><sub></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(6) > code:nth-child(2)
<code class="highlighter-rouge"><sup></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(5) > code:nth-child(4)
<code class="highlighter-rouge"><ins></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(5) > code:nth-child(2)
<code class="highlighter-rouge"><del></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(4) > code
<code class="highlighter-rouge"><cite></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(3) > code:nth-child(3)
<code class="highlighter-rouge">title</code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(3) > code:nth-child(2)
<code class="highlighter-rouge"><abbr></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(2) > code
<code class="highlighter-rouge"><em></code>
html > body > main > div > article:nth-child(3) > ul:nth-child(9) > li:nth-child(1) > code
<code class="highlighter-rouge"><strong></code>
html > body > main > div > article:nth-child(3) > p:nth-child(8) > a
<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element">Mozilla Developer Network</a>
html > body > main > div > article:nth-child(3) > blockquote > p
<p>Curabitur blandit tempus portti...</p>
html > body > main > div > article:nth-child(3) > p:nth-child(4) > a
<a href="#">dis parturient montes</a>
html > body > main > div > article:nth-child(2) > p:nth-child(14) > a
<a href="https://github.com/poole/hyde">GitHub repository</a>
html > body > main > div > article:nth-child(2) > p:nth-child(10) > a
<a href="https://github.com/poole/hyde#readme">Head to the readme</a>
html > body > main > div > article:nth-child(2) > ul:nth-child(9) > li:nth-child(3) > code
<code class="highlighter-rouge"><body></code>
html > body > main > div > article:nth-child(2) > ul:nth-child(9) > li:nth-child(3) > a
<a href="https://github.com/poole/hyde#themes">Eight optional color schemes</a>
html > body > main > div > article:nth-child(2) > ul:nth-child(9) > li:nth-child(2) > code
<code class="highlighter-rouge"><body></code>
html > body > main > div > article:nth-child(2) > ul:nth-child(9) > li:nth-child(2) > a
<a href="https://github.com/poole/hyde#reverse-layout">reverse</a>
html > body > main > div > article:nth-child(2) > ul:nth-child(6) > li:nth-child(3) > code
<code class="highlighter-rouge">rem</code>
html > body > main > div > article:nth-child(2) > ul:nth-child(6) > li:nth-child(1) > a:nth-child(3)
<a href="/about">example page</a>
html > body > main > div > article:nth-child(2) > ul:nth-child(6) > li:nth-child(1) > a:nth-child(2)
<a href="/feed.xml">RSS feed</a>
html > body > main > div > article:nth-child(2) > ul:nth-child(6) > li:nth-child(1) > a:nth-child(1)
<a href="/404">404</a>
html > body > main > div > article:nth-child(2) > p:nth-child(5) > a
<a href="https://twitter.com/mdo">@mdo</a>
html > body > main > div > article:nth-child(2) > p:nth-child(3) > a:nth-child(2)
<a href="http://getpoole.com">Poole</a>
html > body > main > div > article:nth-child(2) > p:nth-child(3) > a:nth-child(1)
<a href="http://jekyllrb.com">Jekyll</a>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(5) > p > code
<code class="highlighter-rouge">google_analytics</code>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(4) > p:nth-child(3) > code
<code class="highlighter-rouge">comments.html</code>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(4) > div > div > pre > code > span:nth-child(5)
<span class="s">my-disqus-shortname</span>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(4) > div > div > pre > code > span:nth-child(3)
<span class="na">shortname</span>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(4) > div > div > pre > code > span:nth-child(1)
<span class="na">disqus</span>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(3) > p > code
<code class="highlighter-rouge">search.html</code>
html > body > main > div > article:nth-child(1) > ul > li:nth-child(2) > p > code
<code class="highlighter-rouge">sidebar_link: true</code>
html > body > main > div > article:nth-child(1) > p:nth-child(13) > code:nth-child(2)
<code class="highlighter-rouge">_includes/custom-foot.html</code>
html > body > main > div > article:nth-child(1) > p:nth-child(13) > code:nth-child(1)
<code class="highlighter-rouge">_includes/custom-head.html</code>
html > body > main > div > article:nth-child(1) > p:nth-child(12) > a
<a href="https://github.com/fongandrew/hydeout/blob/master/_sass/hydeout/_variables.scss">_variables</a>
html > body > main > div > article:nth-child(1) > p:nth-child(10) > code
<code class="highlighter-rouge">assets/css/main.scss</code>
html > body > main > div > article:nth-child(1) > div:nth-child(9) > div > pre > code > span:nth-child(27)
<span class="mh">#268bd2</span>
html > body > main > div > article:nth-child(1) > div:nth-child(9) > div > pre > code > span:nth-child(3)
<span class="mh">#202020</span>
html > body > main > div > article:nth-child(1) > p:nth-child(3) > a:nth-child(2)
<a href="http://jekyllrb.com">Jekyll</a>
html > body > main > div > article:nth-child(1) > p:nth-child(3) > a:nth-child(1)
<a href="https://github.com/poole/hyde">Hyde</a>
You can check these accessibility errors using pa11y.
You can view the full validation results in our website.
Hi. I cloned the repo and pushed it to Github Pages. But it seems the CSS isn't loading. Here's the site: smabie.github.io
Is there something I must do after I clone and push? Thanks!
Hello,
Will it be possible to include support with asciidoctor?
How can I adjust the article width?
When I use wide-monitor, I feel the content width is too small.
I fail to find the proper variables at _variables.scss
thank you.
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.