alshedivat/al-folio

A beautiful, simple, clean, and responsive Jekyll theme for academics

al-folio's Issues

Workflow for adding posts

Hi,

Thanks for the great looking theme! I am finding it difficult to add posts to the blog page and was wondering if you could describe the workflow for the same. Is it as simple as adding another markdown page under the _posts/ directory. If yes, that does not seem to be working for me.

Thanks!

Favicon.ico

Did a favicon ever exist for this theme? The head.html tries to load one from assets/img/ but there is currently any such file in the img folder. I was wondering if this had been accidentally removed at some point, or if it never existed?

Project page

I'm building the project page and have got a few questions.

1. The general layout in my local build is different from the demo website (refer to attached screen caps). There are mainly two differences: 1) project name and descriptions are shown when mouse hover on the picture rather than at the bottom; 2) only part of the images are shown rather than a re-scalled full version. I noted from the other post that the demo website is built from slightly different codes. So I wonder whether the differences I'm currently seeing is also due to that~~?

2. It's weird that somehow for my local build, it's not able to link to imges which are in the assets folder. I got errors for example in project 1 page, saying it cannot find img/6.jpg and img/11.jpg while both are in the folder. Please refer to screen cap.

Many thanks!!

I added quora and medium to social using the following code in _includes/social

{% if site.medium_username %}<a href="https://medium.com/@{{ site.medium_username }}" target="_blank" title="Medium"><i class="fab fa-medium"></i></a>{% endif %}
    {% if site.quora_username %}<a href="https://www.quora.com/profile/{{ site.quora_username }}" target="_blank" title="Quora"><i class="fab fa-quora"></i></a>{% endif %}

Light Font on Mobile view

Can you please tell how to have a darker font when viewed on mobile? It appears very light as of now. Thanks.

version dont update ./bin/deploy

Hi I was able to set up this web with al-folio thank you very much.
https://grjd.github.io/
But it is being a very tortuous process, when I modified pages they didnt update, ruby error messages etc. This is most likely a problem with my own installation but now I am stuck and asking for help.
I have 3 branches in my github for this repo gh-pages, master and old-state (not sure if i need this at all). When I call to deploy i select source as old-state and destination gh-pages, so in old-state is where the "complete" site is. This is the public repo with the 3 branches https://github.com/grjd/grjd.github.io/tree/gh-pages

But local in my com,puter it is left with this

I want to get in my local computer what it is in https://grjd.github.io/
and continue from that point.
I think maybe the ./bin/deploy messes things up, I am a bit confused.

Thank you!
Jaime

Can you enable tracking IP address of visitors

Is there a way to easily integrate ip address of visitors with the code? Using mixpanel or something?
Thanks!

How to add hyperlink in bibliography to the pdf of the paper?

How can I add Hyperlinks on the publications page to pdfs of my papers that are let's say uploaded to a folder called papers under assets? I tried looking at the jekyll-scholar documentation and it suggests mentioning that folder under the "repository" option in the scholar configuration section, and then adding the documents using bibtex key as filename. I'm just not sure how to create the hyperlinks in the publications page on the paper names by using the "links" property as described in jekyll-scholar (https://github.com/inukshuk/jekyll-scholar/#file-repositories). Can anybody suggest what changes I need to make? Perhaps in the bib.html template or in the bibliography query on the publications.md page?

Disabling blog

Hi,
Thanks for the great work.
Sorry this is probably a noob question.

I would like to disable the blog form the website but I could not figure out how.
I tried to add blog and _posts to exclude: in my config file but it only worked partially. The posts do not show up anymore but the blog link is still in the navigation bar. How should I remove the blog link from the top of the page?
Thanks in advance

Navbar not collapsing in mobile

_posts.scss ignored by jekyll serve

When I modify the _sass/_posts.scss file while jekyll serve is running, the auto-updater doesn't pick up on the change to the file, so I have to stop the serve and re-run it to see the changes. This is the only files I've noticed this happening with so far, though I haven't systematically checked all the files. Renaming it seems to fix the problem - obviously this requires changing the relevant import statement in assests/css/main.scss. Anyone have any idea what's going on here?

ERROR: Liquid Exception

I keep getting this error when I deploy it Liquid Exception: uninitialized constant ActiveSupport::Multibyte::Chars::Unicode in _pages/publications.md

font-awesome not showing in local build

Somehow fa icons are not showing up in my local build. But when I deploy it on GitHub pages, they are shown correctly. I wonder why this happens...

Here I enclose a screen shot for my local build.

Thanks!

Social icons not showing

I changed social icons to be true in the config file:

show_social_icons:  true
enable_anchorjs:    true
enable_katex:       true

However, social icons are not showing.

What to do?

about header

Hi,
For all the other pages, the title changes the page header but the title for the about page is my name. Hence, I cannot find a way of changing the "about" header. Any leads would be appreciated.
Thanks

how to run deploy in windows os?

Hi. Thanks for this great theme! It works perfectly on my localhost. I just dont know how to run your deploy script on windows os . Tried deploy.sh but it didnt work. Sorry, I am completly new to github and ruby. Can you please help with that?

Double slash (...github.io//assets/...) in the url when use deploy

When I use : ./bin/deploy, it generating URLs with double slash after ...github.io//... Can you please help pinpoint the issue? I know it's not a problem with the page loading. Thank you.

Deploying permanently to organization page

First, thank you for creating a beautiful theme. This is my first time working with jekyll, so it's possible I am missing something on the jekyll end.

I am trying to deploy to my organisation page, but the webpage turns basic html when I stop the server.

When I run `bundle exec jekyll serve', the webpage renders beautifully:

But, when I stop the server, it renders to a basic html.

I would be surprised if I am expected to keep running the server the whole time. So what am I missing here?

Edit: I looked at the index.html file, and the file path for all files is "localhost:4000/". Even though in _config.yml I left both url: and baseurl: empty.

Can't run jekyll

When I follow the installation instructions, everything goes ok until bundle exec jekyll serve where I get an error message:
Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/main.scss':
Undefined variable: "$viewport-small". on line 7
jekyll 3.8.5 | Error: Invalid US-ASCII character "\xC2" on line 7

I'm on a mac, running ruby 2.6.4 and bundler 2.0.2, and tried some simple file edits to delete any strange characters but didn't find anything.

Thanks for any help!

Help with publications setup

Hi,

First of all, thank you very much for this template! It was extremely easy to setup and with basic html and jekyll knowledge it is pretty straightforward to customize.

I am trying to setup my publication template in a similar way as yours (https://www.cs.cmu.edu/~mshediva/publications/). The main thing I am having trouble automating with jekyll scholar is having the publication venue/conference on the left and also having links to the paper pdf, poster, and abstract. Do you add those links manually?

Thanks!
Felipe

Upgrade to Bootstrap and Material based styles

The next version of al-folio must have responsive styles based on Bootstrap 4 and Material Design.

Desired features:

• Full re-write of styles that makes the theme Boostrap-based and responsive.
• More flexible choice of layouts using _config.py (e.g., fixed/sticky header and footer).
• Responsive projects page (see demo here).
• Fix problems with style bugs on the publications page.

Note: A preview version is already available in the dev branch.

Better author identification in /publications

Hi,

My brother and I do a lot of research together. The current theme only asks for my last name in order to underline my name in my publication list. However, since my brother has the same last name, his name gets underlined as well.

I'm super n00b when it comes to website stuff, I played around but couldn't come up with a solution. Is there any way to fix this ?

btw thanks for the free theme, it's very friendly :)

-Lucas

Your demo of al-folio is completely different from the version on Master

I was trying to set up a page using al-folio, and I was wondering why my Projects page looks so different from the demo version.

By demo digging through Github, it looks to me like the code on the gh-pages branch comes from dev, while the code on Master hasn't been updated in months.

Project Images

Hi,

Thanks for the great help on my last issue!

I notice that this issue is going on in the demo as well, so it's not just me. The problem is that the images used on the projects page only show the top left of the images rather than the entire image. For example, the images in the screen shot should be a gavel on the left, and the Facebook logo on the right, but the left image is getting cut off, and the Facebook logo isn't even visible.

And in the demo below, image 12, the image shown in the on the top row, left column, should have a cup in the image.

How do I fix this so that the entire image is displayed?

Thank you so much in advance!

Best,
Tim

Blog not detecting new posts

Hi,

I recently forked the repo and I am trying to add new blog posts by creating new posts in _posts/ but it does not get updated in the blog (running it locally haven't deployed it yet). Even if the new post is a copy of an old post with only the date being different, the same thing happens.

Any clues?

No Gemfile in repo; internet guide doesn't work

Hi,

It was challenging getting jekyll to run with al-folio. I followed the first link when searching ' Gemfile for Jekyll'. Running

source 'https://rubygems.org' gem 'github-pages', group: :jekyll_plugins

returns an error with bibliography when launching the jekyll server

source 'https://rubygems.org'
group :jekyll_plugins do
gem 'github-pages'
gem 'jekyll-paginate'
gem 'jekyll-scholar'
gem 'jemoji'
end

made it work

Github Build failed

I managed to fork this repo and customize to my site need, everything is working fine while local.. but when I deploy the site a get the following error.

he page build failed for the master branch with the following error:

The tag bibliography on line 6 in _pages/publications.md is not a recognized Liquid tag. For more information, see https://help.github.com/articles/page-build-failed-unknown-tag-error/.

Kindly, help

Changes to the deployment is not reflecting in the git hub page for more than 4 hours.

The repo shows the right versions and contains all of the content to be hosted by the github page. But it does not reflect in the github page itself. I have tried all the different solutions that were mentioned by different sources. None of them seem to help me. Can some one help me out here?

Fotmat is broken?

I run the bundle exec jekyll serve,
the web page works well with the correct format.
but whenever, i push and deploy it on GitHub. the format is broken...could you help me?
you may have a look https://hhhwwwuuu.github.io/wzq/

Blog post comments

Dears,

Great theme: I just love it! A quick question for a feature that would make real difference for me. How complex do you think is to add commenting abilities to the blog posts? Any indications on how would I add that (happy to make a pull request about if I find specific guidance!)

main content shadowed by the footer

I know this is a feature, but I am wondering how I can keep the footer at the page bottom while not letting it shadow the main content. I don't want the footer bar to disturb the reader when the actual page bottom has not been reached.

Any suggestions/pointers would be welcome.

On mobile, images crop instead of scale

The image gallery structure works great on wide devices, but does not scale well, as images are cropped to fit into a narrower box (to stay 3 wide) instead of scaling down or shifting to the next line.

Here's an example of what three images that I have (on collections) look like on browser and mobile:

on web (browser)

on mobile

I think there are a couple of options.

1. modify the base image gallery such that it includes responsive square containers that "contain" the image -> shrink and grow
2. use a media query to make breaks between images for mobile

Perhaps other options?

404 There isn't a GitHub Pages site here.

Describe the bug
Trying to fork this and use for brendanjmeade.github.io. Receiving 404

To Reproduce
Steps to reproduce the behavior:

1. Go to 'brendanjmeade.github.io'
2. See 404 error

Expected behavior
Website template should appear.

System (please complete the following information):

• MacOS Catalina
• Chrome and Safari
• Jekyll version [e.g. 3.8.7]
• Ruby version [e.g. 2.6.5]

Additional context
I'm very much a beginner and appreciate the help!

_includes not assigning links correctly

This may show my nativity, but the html items within the _includes file do not link the correct links within the _site file upon build. See screen shots attached.

How to deploy to github

Hello,

Thank you for sharing a super great repo.
I am pretty new here, and not sure how to run the deploy on Window.
I always get '.' is not recognized as the internal or external command by using CMD for $ ./bin/deploy [--user]

Thank you

Content jumps horizontally whenever browser adds a scrollbar

Page content 'jumps' a little on Safari/Chrome/IE when navigating between short and long pages:
https://alshedivat.github.io/al-folio/blog/ vs https://alshedivat.github.io/al-folio/projects/

Deploy to username.github.io

As you've built this currently, the ./bin/deploy deploys to a gh-page branch on a user's project repo. But, since the (really handsome!) theme you've built is directed toward academic users, I'm not sure this is really meeting the use case -- single users can only host on their master branch, per the documentation.

I had thought about switching default branches? Perhaps making a source branch the default that includes all the _site and _pages and _config.yml etc. content and a master branch that includes only the resulting files and structure within _site? But then, I couldn't get it deploying.

So, the issue, probably labeled an enhancement, is -

• Can a secondary deploy script be written that builds and deploys toward a user who has to host at a username.github.io site?

Editing the content

First, thanks for creating this beautiful theme!

I am familiar with jekyll and github and I was looking into migrating my current website to this theme. However, when I uploaded them to GitHub to deploy/publish the site, I saw that all was converted into different files on a new _site directory.

Now my question is, how could I edit my website in the future? Usually I would edit files in their folders and push them to Github, but I am not sure if it will do the same with the _site folder that I have never worked with before.

Thanks in advance!

error: Liquid syntax error (line 3): Unknown tag 'bibliography' on github.io

Hello,

This theme attracts me a lot. But when I want to use it by setting it as my github page, it reports this error. I have no idea to solve this problem.

Could you help me? I will really appreciate your help!

add page without appearing in the menu

I would like to add a page that doesn't appear on the menu, is there a way to do it?

Thanks!

Links from bib file in publications

Is there a way to generate links from the .bib file in the publications page.

how to include publication into about page

Can we include publication page as one part into about page, like the news part or social part?
It is unclear how to do this with automatic generation of publication page.

The tag bibliography on line 3 in _pages/publications.md is not a recognized Liquid tag

I can build page locally but when I try to deploy at github I get this error:

Your site is having problems building: The tag bibliography on line 3 in _pages/publications.md is not a recognized Liquid tag. For more information, see https://help.github.com/en/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites#unknown-tag-error.

On line 3 _pages/publications.md there is:
permalink: /publications/

Problems with Deployment

Hello,

First of all, thank you very much for such a nice template. I have a very naive question ( I started playing with Jekyll today) that has been puzzling me a lot in the last 2 hours :(

I have created my webpage and it works beautifully on local.
Once deployed with ./bin/deploy I get the message 'Deployed successfully!' and I see I have two branches on my repository. Yet, the page is not loaded (I get 404 error). In the Github page I see this error:

Your site is having problems building: The tag bibliography on line 3 in _pages/publications.md is not a recognized Liquid tag. For more information, see https://help.github.com/en/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites#unknown-tag-error.

in the Github page, it says it wants to build the page from the master branch and I can't put it on the gh page brunch.

Do you have any suggestions?

Thank you very much

Desired features for al-folio 1.0

This issue tracks progress toward 1.0 upgrade of al-folio.

TODOs:

• Improved responsive design (#87).
• New distill.pub-style post template (see demo here).
• Support for GitHub metadata (using github-metadata) (#121)
• Support for Twitter cards (using jekyll-twitter-plugin) (#120)

Note: The progress will be as time permits. Suggestions and contributions are welcome (please submit PRs to the dev branch).

Duplicate files created

Hi! Not sure if I'm missing something very obvious here, but sometimes after building and deploying, duplicate files will be created that then cause problems the next deployment.

For example, in addition to 1-project.md it will create a 1-project 2.md in the same folder. A similar thing happened for all of my images: 1-img.jpg became 1-img 2.jpg and so on.

Project page on mobile devices

The Project page does not display very well on mobile devices.

Can the images be made to shrink uniformly?

Writing equations centered on the page

Hi, Is it possible to center the equations ?

Tried adding \begin{equations} inside $$ and also tried adding css, but nothing seems to work.

blog posts not loading + "about" page issue

First, thank you for a wonderful template.

1. I am having issues with blog posts appearing. At first, I thought I had deleted or changed something after I started customizing, but to test out the cause I forked, cloned, and started everything from scratch. The "blog" page still doesn't work. see: https://cpryan.github.io/blog/ and the image below:

I saw somebody having an issue with 'workflow' and blog posts, and tried both with and without --incremental with the jekyll bundle, but no change.

2. When I navigate to the "about" page from the (broken) blog page, there is 404 error. No idea why this is. Any thoughts?

Here is the repo:
https://github.com/CPRyan/CPRyan.github.io

If anybody has any suggestions, I would be much obliged. I am pretty new to jekyll and even git so please bear with me.

Reverse bibliography order

Is there an easy way to reverse the bibliography order? It's currently posting it in order from oldest -> newest publications. I'd like my most recent publications at the top. I tried adding order: descending and order: ascending to the _config.yml and nothing changed. I also tried reversing the loop in _layouts/bib.html by adding {% for author in entry.author_array reversed %} with no change either.