pages-themes / minimal Goto Github PK

I'd love for the logo to link to a page, perhaps with a logo_url parameter in the _config.yml. It'd be particularly useful when the logo is a CC-BY image from Wikipedia, so the image could link to the original source. As a workaround, I'm setting the description to the URL of the Wikipedia page.

I am using the theme via GitHub pages and notice that the page footer is effectively floating on top of my page content - meaning that the text of my content and the footer are illegible.

The footer is this:
"This page was generated by GitHub Pages. "

Is this the intended design?

For reference, my site is https://daf.lol.

My repo for my site is private cause I occasionally put private stuff on the site to send in emails, and the button being there is redundant.

Thanks!

Hi,

Just wanted to share that sometimes the header and footer can display on top of each other in a desktop browser. When the window becomes narrow enough, it switches to single column display. However, if you just make the window shorter, it keeps the 2 column format and the header and footer can overlap.

Best,
Vincent

Hi,

I'm using this theme for a private repo, and would like to disable the "View the Project on GitHub" button. Is there a way to do this?

I really like the minimal feel this theme gives, but I've come across the need to create more another-page.md like pages to make the front page less cluttered. While the example another-page.html has a back link to get to the front page again, when there are multiple "pages" it would be nice to have them all in the side bar so the user does not need to constantly click back to go through all the pages.

An example of where I think this feature would be helpful is here: https://chendaniely.github.io/2018-10-python1/

How I think this can be easily implemented is in the _layouts/default.html file where we can put a section for sidebar pages in the _config.yaml and it lists those pages in an un-ordered list of sorts.
Would be happy to send the PR if you think this fits with the scope and goals of the project.

I've already overridden the default.html to add a <link rel="shortcut icon"..., but it would be nice if the theme came with support for a favicon out of the box. Perhaps a favicon key could be added to the _config.yml to specify a path to the image asset.

Hello,

I'm trying to preview my site locally and eventually publish it on my github page.

I'm following documentation: I have added theme: jekyll-theme-minimal to my _config.yml file, and I have added gem "github-pages", group: :jekyll_plugins to my Gemfile.

I am now able to run locally with bundle exec jekyll serve but the website still has the base Jekyll theme. Also I have merged on github and githubpage still shows the base Jekyll as well.

Not sure why, sorry for the simple question, I'm new to Ruby and Jekyll.

Any reason for the lack of post layout?

I've just started to use the theme (thanks!) and for posts have removed the title above the content, and put the page title in the header (which I've added to the _config.yml).

This is probably a misuse of an issue, but I want to add custom links to the left side of the index Markdown page. I discovered that I can create a _layouts/default.html file, which works well. However, I'd also like to have different pairings of markdown files and default.html files. Is there a way to do this? Can I specify for a particular markdown file which corresponding default.html I want used?

I love the look of Minima in Google Chrome and Firefox. But in Internet Explorer 11, it appears to be displaying the font as Times new Roman. What's particularly weird is that when I used Internet Explorer's inspector, the font family look like it was showing up properly, and it included several fonts, such as Helvetica and Arial that IE certainly has.

Here's what it looks like with IE 11 on the following page:
https://jekyll.github.io/minima/junk/2016/05/20/this-post-demonstrates-post-content-styles.html

Any idea what's going on?

On the Post layout, how do i add the date

How can I add google analytics to my page?

Although I added an analytics.html file into the _includes folder and linked it to the config.yml file but google could not pull any data.

my page: https://omerayyildiz.com/nishgt
my repository: https://github.com/omerayyildiz/nishgt

Hi
I got this error when setting up github pages with this theme,
the email I got doesn't have any description related with the failure.
I just change the default theme to 'jekyll-theme-minimal', it builds fine when switch back to 'minima' theme.
Thanks.

I'm using this very nice theme but I obtained it via the "change theme" option in the GitHub pages section of settings. This means that I only seem to have access to README.md and _config.yml. Perhaps because of this, or perhaps because I simply have no idea what I'm doing, I'm having some trouble with customising the website.

Is there a way to add more links below "View My GitHub Profile" on the left-hand side? e.g. A link to twitter, or an email link?

Many thanks for making such a great theme!

There are some accessibility problems with this theme.

1. the language of the page should be provided.
2. there are color contrast issues

Maybe this should be reported here though https://github.com/orderedlist/minimal

Not sure.

The user @carlsonsantana validate your site template "https://pages-themes.github.io/minimal/" and found these accessibility errors:

• Page https://pages-themes.github.io/minimal/:
  • Issue 7c9716ac-0cf1-4fbd-8e13-871ae1cfe88a:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Fail
    • Message: This element has insufficient contrast at this conformance level. Expected a contrast ratio of at least 4.5:1, but text in this element has a contrast ratio of 4.49:1. Recommendation: change background to #f9f9f9.
    • Selector: html > body > div > section > div:nth-child(11) > div > pre > code > span:nth-child(4)
    • Context: <span class="no">Dependencies</span>
  • Issue 9fbcf03e-5945-4d98-b526-d990e07ac2da:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Fail
    • Message: This element has insufficient contrast at this conformance level. Expected a contrast ratio of at least 4.5:1, but text in this element has a contrast ratio of 4.49:1. Recommendation: change background to #f9f9f9.
    • Selector: html > body > div > section > div:nth-child(11) > div > pre > code > span:nth-child(2)
    • Context: <span class="no">GitHubPages</span>
  • Issue 887f35e1-56b9-4be8-92b8-831dac729f70:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Fail
    • Message: This element has insufficient contrast at this conformance level. Expected a contrast ratio of at least 4.5:1, but text in this element has a contrast ratio of 2.72:1. Recommendation: change text colour to #737362.
    • Selector: html > body > div > section > div:nth-child(11) > div > pre > code > span:nth-child(1)
    • Context: <span class="c1"># Ruby code with syntax highlig...</span>
  • Issue bd91bd1f-5ead-4f55-96f4-cf663de1b80c:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Fail
    • Message: This element has insufficient contrast at this conformance level. Expected a contrast ratio of at least 4.5:1, but text in this element has a contrast ratio of 2.72:1. Recommendation: change text colour to #737362.
    • Selector: html > body > div > section > div:nth-child(10) > div > pre > code > span:nth-child(1)
    • Context: <span class="c1">// Javascript code with syntax ...</span>
  • Issue 22afde61-cd46-4cbb-be9d-f65147e6a502:
    • Type: Error
    • Code: WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Fail
    • Message: This element has insufficient contrast at this conformance level. Expected a contrast ratio of at least 4.5:1, but text in this element has a contrast ratio of 4.48:1. Recommendation: change text colour to #767676.
    • Selector: html > body > div > header > p:nth-child(4) > a > small
    • Context: <small>pages-themes/minimal</small>

You can check these accessibility errors using pa11y.
You can view the full validation results in our website.

I added a README.md to my git-hub repository but the content of my README.md overlap the title. The title is just the name of my repo

I have a project page (https://user.page/project)

In my index.html if I make a link like so:

<a href="/foo/">/foo</a>

The link builds as https://user.page/foo

rather than https://user.page/project/foo (as expected)

I went so far as to add a base tag to the head.

<base href="{{ site.url }}">

I have other project pages that create the urls just fine, and I have the same settings in config.yml.. so I'm at a loss.

https://infominer.id/bitcoin-history

the very first link on that page is an example ^^^

thank you!

I am using this theme but I would like to use fenced code blocks for code snippets in my page and it is not working. Nevertheless the {% highlight python %} ... {% endhighlight %} is working.

How to fix it?

Best,

Luis Santos

Hi! At the present the three options for package downloading are directly hardcoded into the HTML layout and the third one of them is repetitive with "View on Github". Do you think it could be easily extendable to any three options (button texts and links) we would like to add? They can still be three in order to obey the overall layout so there is no need to make anything other than the texts and links configurable. For instance, I would like my three options to be PIP/RPM/DEB. Any help is appreciated!

Is inline style supported in minimal. It is just showing the alt text!

Is it possible to modify in the _config.yml or jekyll Front Matter the setting for site.github.is_project_page in order to modify the behaviour of the website-building in _layouts/defaut.html

I tried several combination, but did not get it to work. Thanks in advance!

I do not have a index.html file. I only want to host my readme file. How would I do that?

Simply adding this theme on GitHub pages is not working

Thank you for a wonderful theme!

is there an easy way to include ToC inside the header (left side) of the layout? I was hoping I could enable it via a variable, but looking at https://github.com/pages-themes/minimal/blob/master/_layouts/default.html it doesn't seem possible without modifying the layout HTML which I'm very uncomfortable with.

Thanks!

I tried to install this theme and the installation worked. However, my table that showed up on another theme just fine.

I am using the minimal them in a couple simple repos. I want to add links to each page on the side of the page (above the "View the project on GitHub" button but below the logo. How can I do this?

It'd be awesome if minimal would support

@media (prefers-color-scheme: light | dark)

and/or have an explicit toggle for users

and/or have a _config.yaml option

Thanks!

The page title seems a bit long with the combination of the site title and its author (which requires github btw). Would it make sense to shorten it by eliminating the author info? This would leave it:

Here are two examples. Here is a link to one of my posts: post_1.
As you reduce the width of the browser window the contents of the post is correctly pushed into new lines.

Here is another example: post_2.
If we reduce the window width we can see that some contents are not pushed to the next line. Instead part of the content is displayed off of the screen (or browser window).

It seems the problem is caused by the code snippet block: ```C some code ```. By removing those blocks, the layout returns to normal state. (More specifically, if the code in the block exceeds certain length then they will be displayed entirely in one line instead of showing scrolling options.) It seems the display size is set to the max code block width instead of screen width. Mathjax also causes the page width to be set to that of the longest formula in the post. Is there any to fix the issue on mobile devices? Thanks.

In

Dear Minimal theme,

I would love to see LaTeX support for the theme; this would be extremely helpful for writing equations in text. I have attempted to write code in my own branch of minimal to implement MathJax, as per the instructions here: http://sgeos.github.io/github/jekyll/2016/08/21/adding_mathjax_to_a_jekyll_github_pages_blog.html

Unfortunately, my implementation was not successful; I am a GitHub novice, so that might be why it failed. It should only be a few lines of code.

Best wishes,

Jason

How do I increase vertical space between list items in the menu?
Thank you

I realized that the default font for the title (Noto Sans Bold) doesn't support some characters (namely 'ě'). Is there a way to replace this font completely with my own with scss, or do I need to manually set it on the elements where it's used?

Repository https://github.com/ajwadjaved/ajwadjaved.github.io
Website ajwadjaved.github.io, its giving me a 404 now

https://github.com/pages-themes/minimal/blob/master/_layouts/post.html#L12

On my blog, I was observing a post that had 0 tags (no tag in the frontmatter), yet the tags showed up on the page with an empty string.

I believe Jekyll is loading a single tag with value equal to "".

In my blog, I switched this check to be:

{% if page.tags[0].size > 0 %}

I am happy to contribute this to this project, or work towards a better solution.

I followed the theme usage instructions and the site does not build after configuring the theme. There is a theme could not be found error. Did I miss something? How do I get the site to build with the theme configured?

/tmp $ jekyll -v
jekyll 3.8.3
/tmp $ ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin15]
/tmp $ jekyll new minimal-test-site
Running bundle install in /private/tmp/minimal-test-site...
  Bundler: The dependency tzinfo-data (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for x86-mingw32, x86-mswin32, x64-mingw32, java. To add those platforms to the bundle, run `bundle lock --add-platform x86-mingw32 x86-mswin32 x64-mingw32 java`.
  Bundler: Fetching gem metadata from https://rubygems.org/...........
  Bundler: Fetching gem metadata from https://rubygems.org/.
  Bundler: Resolving dependencies...
  Bundler: Using public_suffix 3.0.2
  Bundler: Using addressable 2.5.2
  Bundler: Using bundler 1.16.2
  Bundler: Using colorator 1.1.0
  Bundler: Using concurrent-ruby 1.0.5
  Bundler: Using eventmachine 1.2.7
  Bundler: Using http_parser.rb 0.6.0
  Bundler: Using em-websocket 0.5.1
  Bundler: Using ffi 1.9.25
  Bundler: Using forwardable-extended 2.6.0
  Bundler: Using i18n 0.9.5
  Bundler: Using rb-fsevent 0.10.3
  Bundler: Using rb-inotify 0.9.10
  Bundler: Using sass-listen 4.0.0
  Bundler: Using sass 3.5.6
  Bundler: Using jekyll-sass-converter 1.5.2
  Bundler: Using ruby_dep 1.5.0
  Bundler: Using listen 3.1.5
  Bundler: Using jekyll-watch 2.0.0
  Bundler: Using kramdown 1.17.0
  Bundler: Using liquid 4.0.0
  Bundler: Using mercenary 0.3.6
  Bundler: Using pathutil 0.16.1
  Bundler: Using rouge 3.1.1
  Bundler: Using safe_yaml 1.0.4
  Bundler: Using jekyll 3.8.3
  Bundler: Using jekyll-feed 0.10.0
  Bundler: Using jekyll-seo-tag 2.5.0
  Bundler: Using minima 2.5.0
  Bundler: Bundle complete! 4 Gemfile dependencies, 29 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.
New jekyll site installed in /private/tmp/minimal-test-site.
/tmp $ cd minimal-test-site
/tmp/minimal-test-site $ cat _config.yml | grep theme
theme: minima
/tmp/minimal-test-site $ sed -i '' "s/minima/jekyll-theme-minimal/g" _config.yml
/tmp/minimal-test-site $ cat _config.yml | grep theme
theme: jekyll-theme-minimal
/tmp/minimal-test-site $ bundle exec jekyll serve
Configuration file: /private/tmp/minimal-test-site/_config.yml
jekyll 3.8.3 | Error:  The jekyll-theme-minimal theme could not be found.

Hi,

I found an issue from ci.yaml as below:

Run script/bootstrap
/home/runner/work/_temp/63854597-b0cf-41b3-a7a5-dc2b0c4df45f.sh: line 1: script/bootstrap: Permission denied
Error: Process completed with exit code 126.

Any advice on how I can eliminate this error?

Thank you

If I want to put a unordered list like this in the sidebar:

I get something like this:

I believe this is because of minimal's special treatment of lists in the sidebar for the Download links. However, I am aiming for a list like the first one I showed - one that is the same as a list in the rest of the page.

There should be a rule to only make lists in the sidebar this way with a special class, so that users can have regular unordered lists in the sidebar.

If I'm trying to preview an XML code snippets, The page design is breaking. please following the given instruction

---
layout: default
---
1. _Add the following:_
```xml
<string name="test" translatable="false">TEST</string>
```

The result is like below

If I add a tab or anything character except space before the opening angle bracket it works like a charm.

Is there a way to decrease the size of the left frame (containing the logo) and increase that of the right frame?

I played around in "jekyll-theme-minimal.scss" with the following width values:

header {
width:270px;
float:left;
position:fixed;
-webkit-font-smoothing:subpixel-antialiased;
}

header {
padding-right:320px;
}

section {
width:500px;
float:right;
padding-bottom:50px;
}

The result looked fine on the PC but didn't work on my mobile phone. I also checked the internet for information but couldn't find any help. Does anyone know?

For a user page, the GitHub link is behind the fixed wording "View My GitHub Profile". In our case, this wording (specifically the word "my") doesn't quite make sense as the profile is for an organisation, rather than a user.

Would it be possible to allow the wording to be customised for such links?

This issue has been brought up before: See Issue #19.

If a theme user tries to customize the theme by adding a new <ul> to the sidebar (the <header> section of _layouts/default.html), the theme will try to style the list like the three element downloads list.

The expected behavior would be for the <ul> to inherit the default body style (or some sane default), allowing the user to more easily write custom styles in assets/css/styles.scss.

I think this can be fixed easily by rewriting the downloads list to be a special class of ul (which I will do), but I opened this issue in case there are other considerations here that I'm unfamiliar with, seeing as the issue has been closed previously without a fix.

Hi 😄

Just a small suggestion. Shouldn't the nav manu on the sidebar be more semantic using unordered lists instead of <p>'s? Should be simple enough to use a class for naviation purposes

Thanks a lot for your work!!

Q.

by {{ page.author | default: site.author }}

{{ page.author | default: site.author }}
This item comes to import your data from anywhere.
Display is labeled only by.

31 August 2018 - date
metamask Setup.-title
by - only by

A Example : 404.md

Dear developers, I found that when the image we choose in _config.yml(logo: /assets/img/xxxxx.jpg) is too long, the 'View My GitHub Profile' botton and 'orderedlist' button will overlap and the 'View My GitHub Profile' botton cannot be clicked. Maybe this is a bug? Or just I made the settings wrong?

Really like these themes, but currently cannot use them as they contain Google Analytics tracking. According to a ruling in the The Court of Justice of the European Union (CJEU) in November 2019, "analytics and tracking" is considered non-necessary cookies and so requires opt-in consent from the user before setting any cookies. Would therefore like this feature to be configurable in site settings to avoid breaking the law.

I wanna add an icon to my site, but it doesn't accept it. I got a 32x32 image on Github, and theme is minimal. But, my site is in Cayman right now and the icon is making it crash. Can you tell how to solve this error? Must I use an ico file?