Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

deploy crash with Liquid Exception: Zero vectors can not be normalized in /REPO/_layout/post.html #1203

Closed
MuhammedSabbagh opened this issue Feb 22, 2023 · 29 comments · Fixed by #1266
Labels

Comments

@MuhammedSabbagh
Copy link

Acknowledge the following

  • [*] I carefully read and followed the Getting Started guide.
  • [*] I read through FAQ and searched through the past issues, none of which addressed my issue.
  • [*] The issue I am raising is a potential bug in al-folio and not just a usage question.
    [For usage questions, please post in the Discussions instead of raising an issue.]

Describe the bug
1- related posts which has been just recently added causes cibuild and deployment to fail after adding more than one post
2- when i push to gh-pages directly (which i've mistakenly done) i see the site doing all fine but posts return no article and any click to tags return me back home (or the about page to be precise)
log :

Liquid Exception: Zero vectors can not be normalized in /home/muhammed/development/muhammedsabbagh.github.io/_layouts/post.html
------------------------------------------------
Jekyll 4.3.2 Please append --trace to the build command
for any additional information or backtrace.
------------------------------------------------
/home/muhammed/gems/gems/matrix-0.4.2/lib/matrix.rb:2398:in normalize': Zero vectors can not be normalized (Vector::ZeroVectorError) from /home/muhammed/gems/gems/classifier-reborn-2.3.0/lib/classifier-reborn/lsi/content_node.rb:108:in raw_vector_with'
from /home/muhammed/gems/gems/classifier-reborn-2.3.0/lib/classifier-reborn/lsi.rb:386:in node_for_content' from /home/muhammed/gems/gems/classifier-reborn-2.3.0/lib/classifier-reborn/lsi.rb:221:in proximity_array_for_content'
from /home/muhammed/gems/gems/classifier-reborn-2.3.0/lib/classifier-reborn/lsi.rb:296:in find_related' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/related_posts.rb:45:in lsi_related_posts'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/related_posts.rb:22:in build' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/document.rb:403:in related_posts'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/drops/site_drop.rb:58:in related_posts' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/drops/drop.rb:128:in public_send'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/drops/drop.rb:128:in []' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/drops/site_drop.rb:19:in []'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/context.rb:197:in lookup_and_evaluate' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/variable_lookup.rb:48:in block in evaluate'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/variable_lookup.rb:38:in each_index' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/variable_lookup.rb:38:in evaluate'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/context.rb:159:in evaluate' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/for.rb:130:in collection_segment'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/for.rb:74:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:103:in render_node_to_output'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:82:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:206:in block in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:240:in with_profiling' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:205:in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:218:in render!' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:39:in block (3 levels) in render!'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:59:in measure_counts' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:38:in block (2 levels) in render!'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:63:in measure_bytes' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:37:in block in render!'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:70:in measure_time' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:36:in render!'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/inclusion.rb:16:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/tags/include.rb:208:in block in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/context.rb:123:in stack' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/tags/include.rb:206:in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:103:in render_node_to_output' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:91:in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:46:in block (2 levels) in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:44:in each'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:44:in block in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/context.rb:123:in stack'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:43:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:103:in render_node_to_output'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:82:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:46:in block (2 levels) in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:44:in each' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:44:in block in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/context.rb:123:in stack' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/tags/if.rb:43:in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:103:in render_node_to_output' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/block_body.rb:82:in render'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:206:in block in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:240:in with_profiling'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:205:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/liquid-4.0.4/lib/liquid/template.rb:218:in render!'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:39:in block (3 levels) in render!' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:59:in measure_counts'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:38:in block (2 levels) in render!' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:63:in measure_bytes'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:37:in block in render!' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:70:in measure_time'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/liquid_renderer/file.rb:36:in render!' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/renderer.rb:129:in render_liquid'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/renderer.rb:192:in render_layout' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/renderer.rb:161:in place_in_layouts'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/renderer.rb:93:in render_document' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/renderer.rb:63:in run'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:572:in render_regenerated' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:557:in block (2 levels) in render_docs'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:556:in each' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:556:in block in render_docs'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:555:in each_value' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:555:in render_docs'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:210:in render' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/site.rb:80:in process'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/command.rb:28:in process_site' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/commands/build.rb:65:in build'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/commands/build.rb:36:in process' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/command.rb:91:in block in process_with_graceful_fail'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/command.rb:91:in each' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/command.rb:91:in process_with_graceful_fail'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/lib/jekyll/commands/build.rb:18:in block (2 levels) in init_with_program' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in block in execute'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in each' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in execute'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/mercenary-0.4.0/lib/mercenary/program.rb:44:in go' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/mercenary-0.4.0/lib/mercenary.rb:21:in program'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/jekyll-4.3.2/exe/jekyll:15:in <top (required)>' from /home/muhammed/gems/bin/jekyll:25:in load'
from /home/muhammed/gems/bin/jekyll:25:in <top (required)>' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli/exec.rb:58:in load'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli/exec.rb:58:in kernel_load' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli/exec.rb:23:in run'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli.rb:492:in exec' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/vendor/thor/lib/thor/command.rb:27:in run'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/vendor/thor/lib/thor/invocation.rb:127:in invoke_command' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/vendor/thor/lib/thor.rb:392:in dispatch'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli.rb:34:in dispatch' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/vendor/thor/lib/thor/base.rb:485:in start'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/cli.rb:28:in start' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/exe/bundle:45:in block in <top (required)>'
from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/lib/bundler/friendly_errors.rb:117:in with_friendly_errors' from /home/muhammed/.local/share/gem/ruby/3.0.0/gems/bundler-2.4.7/exe/bundle:33:in <top (required)>'
from /home/muhammed/gems/bin/bundle:25:in load' from /home/muhammed/gems/bin/bundle:25:in

'

To Reproduce
Steps to reproduce the behavior:

  1. have related posts enabled on _config.yml
  2. have 2 or more posts (despite being linting checked)
  3. use /bin/cibuild
  4. See error

Expected behavior
1- deployment should return a pass
2- i should see posts

Screenshots
If applicable, add screenshots to help explain your problem.

System (please complete the following information):

  • OS: EndeavourOS (Arch Linux) [64 bit x86]
  • chromium 108.0.5359.94 (Official Build) Arch Linux (64-bit)
  • Jekyll version [4.3.2]
  • Ruby version [3.0.5p211]

Additional context
disabling related posts fixed the problem
image
the post pages (despite having 2 posts or more) didn't show anything

now i have passing deploy
i can see posts
i can see websites

sorry if i have been rude in any place on this issue, and thank you!

@dh031200
Copy link

dh031200 commented Mar 2, 2023

@MuhammedSabbagh

I have same issue. Finally I find solution.
In my case when I changed this option in _config.yml
true -> false

related_blog_posts:
  enabled: false
  max_related: 5

Deployment completed successfully.

@MuhammedSabbagh
Copy link
Author

@MuhammedSabbagh

I have same issue. Finally I find solution. In my case when I changed this option in _config.yml true -> false

related_blog_posts:
  enabled: false
  max_related: 5

Deployment completed successfully.

i actually stated that in additional context aka "disabling related posts fixed the issue" so we are waiting to see if the feature gets fixed or not, the blog how ever works perfectly without it anyway

SaffiKelleyKieffer pushed a commit to SaffiKelleyKieffer/SaffiKelleyKieffer.github.io that referenced this issue Mar 12, 2023
- Update from upstream
- Set related blog posts to false to allow site to build correctly following alshedivat#1203
github-actions bot added a commit to SaffiKelleyKieffer/SaffiKelleyKieffer.github.io that referenced this issue Mar 12, 2023
- Update from upstream
- Set related blog posts to false to allow site to build correctly following alshedivat#1203 [ci skip]
@george-gca
Copy link
Collaborator

This works in the main repo, so something is not right.
Are any of your blog posts empty? As stated here, empty or really small blog posts without meaningful words (i.e. only stop words used to (?) break LSI.

@Szymok
Copy link

Szymok commented Mar 15, 2023

I have the same problem. Only have default and 2 non empty blog posts

@george-gca
Copy link
Collaborator

Can you share some code, so I can try it?

@Szymok
Copy link

Szymok commented Mar 15, 2023

2023-03-06-ai-trends.md
2023-03-13-ai-writing.md
This two posts probably couse the error, but i do not know why

@george-gca
Copy link
Collaborator

george-gca commented Mar 16, 2023

Does it work when you run locally? For example, running like this? But when about to get to the bundle exec... command, run it like this: bundle exec jekyll serve --lsi. I just tried these two posts in an offline setup, just adding them to the list of posts of the original template, and it worked just fine.

Just want to be sure that the problem is when uploading to a Github page, and doesn't happen when running locally.

@Szymok
Copy link

Szymok commented Mar 16, 2023

Yep - it is working. I disabled the related_blog_posts and github pages also is working

@george-gca
Copy link
Collaborator

Can you try to remove only these blog posts and enable again the related_blog_posts to check if the problem is with them?

@Szymok
Copy link

Szymok commented Mar 16, 2023

After removing posts and enabling related_blog_posts - still the same problem

@george-gca
Copy link
Collaborator

george-gca commented Mar 16, 2023

In your case, more specifically, might be a problem of the classifier reborn plugin handling the different characters you use in your files due to your language. This is the plugin responsible for calculating related posts.

Just to be sure, try to move all your posts somewhere else, get the original posts from the repo and put them on the _posts/ directory, and run with related_blog_posts enabled, check if this still happens.

@Szymok
Copy link

Szymok commented Mar 16, 2023

Still error

@george-gca
Copy link
Collaborator

george-gca commented Mar 16, 2023

I guess this is the repo you are using right? If this is the case, the problem lies in the announcements.

Internally, the announcements that sit in the _news/ directory use the layout: post. The calculus for similar posts are made for every post, which means every page that uses layout: post. To fix this, you can either add more text to your announcements, to avoid these errors, or add related_posts: false in your announcements. This is the way to avoid getting related posts for only one specific post.

@george-gca
Copy link
Collaborator

@MuhammedSabbagh maybe this is the same issue for you?

ZhipengHe added a commit to ZhipengHe/zhipenghe.github.io that referenced this issue Mar 16, 2023
github-actions bot added a commit to ZhipengHe/zhipenghe.github.io that referenced this issue Mar 16, 2023
george-gca added a commit to george-gca/multi-language-al-folio that referenced this issue Mar 16, 2023
…errors like alshedivat#1203

Signed-off-by: George Araújo <george.gcac@gmail.com>
@Szymok
Copy link

Szymok commented Mar 16, 2023

Thank you, that works!

@thispath98
Copy link

thispath98 commented Mar 16, 2023

@george-gca
I got same Zero vector issue. When I started to deploy one posts in _posts directory, (there was no _posts dir. and posts, I deleted), the bug appears.

I can't handle through enabling related_blog_posts, because everytime I change and start to deploy, then same Zero vector error comes out. And then the commit was all gone, changes are reverted into original one as before I committed. Can you help me?

@george-gca
Copy link
Collaborator

I don't think I understood. Can you explain it better @thispath98?

@thispath98
Copy link

thispath98 commented Mar 17, 2023

@george-gca
Sorry, my English is bad.

related_blog_posts:
    enabled: true
    max_related: 5

My current setting in _config.yml.
I disabled it as enabled: false, and tried to deploy it. But depolyment is not successful(Zero vector error occurs), settings I made a change is undone like enabled: true.

@george-gca
Copy link
Collaborator

The error happens when enabled: false? That is really strange. Do you have some code that you can share?

It sounds like a really dumb question, but have you saved the file after changing it?

Also, is it working offline?

@thispath98
Copy link

Yes. You can see my repo in here

And Yes. I have saved the files(_config.yml, 1 post in _posts directory). Because I can't add or commit if there are no changes, yes I saved it.

Lastly, no. My website is totally fine to work. I wonder why I made a change and committed, but error occurs, repository has no record on commits.

@george-gca
Copy link
Collaborator

Just saw your repo, and your main branch is empty 😨
All the Github actions configured on the repository (to build your site, make it online) is based on the main branch.

@george-gca
Copy link
Collaborator

I would recommend creating your site again from the template, and making the modifications one by one, so it is easier to identify if and when it breaks. Also, try to run all the changes offline before submitting to your branch to deploy it online. If you want a more step by step guide, you can check this post.

Just change the last step, when running locally, for bundle exec jekyll serve --lsi to enable the related_posts calculus.

@thispath98
Copy link

Thanks! I agree with your opinion to start it from the bottom. I'll try it after reading manual exhaustively, Thank you!

@george-gca
Copy link
Collaborator

You don't need to read a manual exhaustively, you just need to try to do small changes, one step at a time, and see how it goes. If it works like intended, great. If not, it is easy to revert. Just try again from scratch, make sure the original template run locally, then start doing the changes.

@thispath98
Copy link

Thanks again. I would like to ask you something about main branch.

Previously, I deployed changes using bin/deploy --user after I add, commit, except pushing it to remote repository.

Can you explain how to push it to main branch? Or can you show some posts about this?

@dh031200
Copy link

here is deployment section.
Follow that process and push to main branch.

You don't need to do these.

(click to expand) Manual deployment to GitHub Pages:
(click to expand) Deployment to another hosting server (non GitHub Pages):
(click to expand) Deployment to a separate repository (advanced users only):

@george-gca
Copy link
Collaborator

You don't need to deploy anything by hand. The whole template is already setup so your only work (after you configured your github repo according to the To enable automatic deployment part) is to create your content and commit in your main branch.

The setup I would recommend (and that I used myself):
1 - create your own repo from this template by clicking Use this template in the main repo page
2 - create your local setup following the instructions from here. Since I struggled myself in the beginning (I never used ruby or jekyll before), I wrote a step-by-step tutorial on how to install rbenv and run your site locally
3 - everything is working locally, then follow the instructions on the deployment section, more specifically the part For personal and organization webpages and To enable automatic deployment
4 - make sure the default template works in your-user.github.io
5 - Then, and only then, you start to make your modifications

The workflow I recommend (and use):
1 - test your changes locally first, preferably making small changes at a time and commiting them
2 - everything works, then push to you main repo

@george-gca
Copy link
Collaborator

Also, @dh031200 I believe your related_blog_posts error was due to the same problem as here

@thispath98
Copy link

Thank you @george-gca @dh031200 !! Now I know what I have to do 😊

alshedivat pushed a commit that referenced this issue Mar 19, 2023
Added `related_posts: false` to the announcements front matter to avoid
errors like #1203. Also included explanation in README FAQ section.
Demi-wlw added a commit to Demi-wlw/Demi-wlw.github.io that referenced this issue Mar 19, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
passalis added a commit to passalis/passalis.github.io that referenced this issue Apr 22, 2023
* Update _config.yml

* Update bug_report.md

* Fix latex rendering issue in the bibliography entries (alshedivat#358)

* adds submenu in navigation bar. (fixes issue alshedivat#159) (alshedivat#334)

* adds submenu in navigation bar. (fixes issue alshedivat#159)

* Updated scss files to change hover animations on dropdown submenus, on both dark mode and light mode

* Revert "Change gitcdn link (alshedivat#234)" (alshedivat#364)

This reverts commit 0e4df83.

* minor updates to CONTRIBUTING and LICENSE, add website (alshedivat#365)

* Revert jekyll-scholar bibtex filters (alshedivat#381)

* Revert "Fix latex rendering issue in the bibliography entries (alshedivat#358)"

This reverts commit e328dc6.

* Update mathjax version to 3.2.0

* Add bibtex_filters explicitly to _config.yml

* add website (alshedivat#383)

* Add 'main' branch for newer GitHub repositories (alshedivat#389)

* add stackoverflow id (alshedivat#400)

* Add 404.html (alshedivat#412)

* add jekyll target blank plugin (alshedivat#404)

* add jekyll target blank

* Remove manual target blank from everywhere

* Update README.md

* Set ruby version to 3.0.2 in the deploy script

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* Add jekyll-diagrams (alshedivat#333)

* Add mermaid support via jekyll-diagrams

* Add mermaid install to deploy workflow

* Update README.md

* Update README.md

* Update README.md

* Add RSS icon to social.html (alshedivat#418)

* Add rss icon

* Add a blank line to make sure rss icon is always at the last

* Update README.md

* adds color transition support to li elements (alshedivat#434)

* Adding month to publication section (alshedivat#433)

* Update deploy.yml (alshedivat#436)

‘action’ is deprecated, change to ‘ruby’
https://github.com/ruby/setup-ruby

* Optimize Website Load Time (alshedivat#435)

* Place js files after body tag

* Add Analytics to the end of script

* Minor nits and fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Add support for responsive images (alshedivat#439)

* Added Jekyll-Archives (for tags, categories) and Jekyll site-map (alshedivat#346)

* Add webpage to academic pages list

* adding panelbear analytics

* added categories for projects and horizontal mode display for projects

* rewrote the code to ensure it works properly with current project definitions

* Style adjustments

* added blockquote format, jekyll-archives, tag, year archive pages, and reading time.

* added archive meta to blog posts list and individual posts.

* added sitemap

* stylistic modifications to jekyll-archive addition

* Minor fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Optimize dark theme (alshedivat#431)

* Optimize dark theme

* Fix-up

* Minor fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Add best practices info to README

* Remove theming dependence on jquery

* Update README.md

* Update README.md

* remove extra space in profile image path (alshedivat#451)

* Revert "remove extra space in profile image path (alshedivat#451)" (alshedivat#468)

This reverts commit 0a8bfb4.

* Fix broken read_time in blog/index.html (alshedivat#469)

* Lighthouse enhancements (alshedivat#445)

* Add TOC to distill blog posts (alshedivat#470)

* Fix a small bug in _includes/responsive_img.html

Correctly fixes the issue mentioned in alshedivat#471.

* Add a website to list of academics websites (alshedivat#473)

* Switch to uing <picture> for responsive images

* Use WebP responsive images (alshedivat#498)

This PR replaces the jekyll-responsive-images with jekyll-imagemagick for responsive WebP images.

WebP images are much smaller compared to PNG and JPEG, faster to load and most of the modern browsers recommend it.

More information about WebP images: https://developers.google.com/speed/webp

* Delete assets/resized directory from GIT (alshedivat#440)

* Update 2015-10-20-math.md (alshedivat#514)

Typo

* Better SEO, OpenGraph, schema.org and clean generated code (alshedivat#481)

* Fix distill dark mode again (alshedivat#517)

* Correctly slugify distill TOC (alshedivat#519)

* Correctly slugify distill TOC

* Add special character to demo distill post's TOC

* Minor fixes (alshedivat#522)

* Fix distill collapsible Navbar (alshedivat#524)

* Update library versions (bootstap, jquery, fontawesome, academicicons, masonry, mdbootstrap) (alshedivat#521)

* added my website to readme examples (alshedivat#530)

* Add website to README.md (alshedivat#533)

* fixed title for og preview, otherwise its "blank" (alshedivat#531)

* fixed title for og preview, otherwise its "blank"

* Update _includes/metadata.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Add my personal website to Readme examples (alshedivat#535)

* Add my own site to the readme (alshedivat#545)

* Update README.md and LICENSE year (alshedivat#544)

* Change -webkit-transition to transition-property (alshedivat#540)

As per https://developer.mozilla.org/en-US/docs/Web/CSS/@media/-webkit-transition, webkit-transition feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes.

* Layout Spacing problem when footer_fixed: false (alshedivat#554)

* fix space

* Minor adjustments

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* Add Yang's webpage (alshedivat#559)

* Fix a small bug in news (alshedivat#560)

* Theme and responsiveness fixes (alshedivat#509)

* Dark themed cards

* Responsiveness fixes

* added dark stylesheet option

* highlight theme toggle

* added highlight function

* added highlight themes to assets/css

* offline highlight implementation

* Fixes for masonry

* Revert "added highlight themes to assets/css"

This reverts commit ee7cb76.

* Update `code syntax highlighting` to use jsdelivr CDN

* Project card responsiveness fixes

* added personal website to readme

veedata.github.io

* Reverted responsiveness chnages

* Minor adjustments

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* enable blog to redirect to asset (alshedivat#550)

* Add custom favicon if needed (alshedivat#386)

* Fix alshedivat#565

* mention K-Wu personal website in readme (alshedivat#575)

* Added amalawilson.com to the list of user samples (alshedivat#595)

* Added a star (alshedivat#617)

* Empty entrytype if not article or inproceedings (alshedivat#578)

For bibtex entries that are neither articles nor proceedings, the value `entrytype` carries over from the previous entry in the loop, leading to incorrect displays. This PR fixes that.

* Fix table colors in dark mode (alshedivat#624)

* Call bash on bin/deploy in github actions (alshedivat#625)

* Add support for external blog posts (alshedivat#647)

* Add support for external blog posts

* Cosmetic fixes

* Added documentation on publication buttons (alshedivat#651)

* Added documentation on publication buttons

* Added missing </details>

* Added bibtex filter to hide custom bibtex keywords from bib file output (alshedivat#652)

* Add a new star (alshedivat#667)

Add a start to list of academic personal webpages

* Delete `travis.yml` (alshedivat#665)

* Add `jekyll-minifier` (alshedivat#668)

* Remove obsolete plugins

* Add `jekyll-minifier`

* Add `JEKYLL_ENV=production`

* Add support for `nav_order` and Fix hardcoded navbar titles (alshedivat#664)

* Minor fixes for previous PR alshedivat#668 (alshedivat#672)

* Fix theme (alshedivat#697)

* fix theme

* fix theme

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>

* Add support for CV (alshedivat#628)

* Minor changes and fixes (alshedivat#726)

* Support for cicular image (alshedivat#728)

* Adds vertical scrollbar to news (alshedivat#729)

* Update Lighthouse PageSpeed Insights

* Adds support for bypassing GitHub Pages Jekyll processing (alshedivat#738)

* Adds support for preview images for publications (alshedivat#730)

* Adds support for publication teaser

* Adds an example for publication teaser

* Update example publication teaser

* Update size

* change `teaser` to `preview`

* Update _config.yml

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Adds support for tag-list (alshedivat#734)

* Adds support for tag-list

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Made tags optional

* Responsive deign for tag-list

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Fix typos in _layouts/about.html (alshedivat#739)

* add star (alshedivat#744)

* Change imagemagick optional to depend on one variable (alshedivat#745)

* Fix Previous PR (alshedivat#745) (alshedivat#746)

* Fix responsive image (alshedivat#748)

* fix

* base url

* Revert "base url"

This reverts commit 2e81d32.

* fix

* Better bundler caching for GitHub Actions (alshedivat#750)

* Better caching for GitHub Actions

* Update `actions/checkout` to `v3`

* docs: add alshedivat as a contributor for design, code (alshedivat#751)

* docs: update README.md [skip ci]

* docs: create .all-contributorsrc [skip ci]

* Update .all-contributorsrc

* Update README.md

* Update .all-contributorsrc

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* docs: add rohandebsarkar as a contributor for code (alshedivat#752)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>

* Add Dockerfile for easy installation on local machine  (alshedivat#532)

* docs: add pourmand1376 as a contributor for code (alshedivat#753)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>

* Update README.md

* Update README.md

* Update README.md

* Adds support `max_author_limit` (alshedivat#732)

* Adds support max author limit

* typo

* fix

* display all authors by default

* Added an example

* Added 'and' before the last author

* Improve hiding/showing more authors

* Add title text

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>
Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Fix scripts (alshedivat#755)

* Include bootstrap bundle (alshedivat#756)

* Bootstrap js SRI fix (alshedivat#757)

* fix more authors bug (alshedivat#758)

* fix more authors bug

* fix

* add preview

Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@gmail.com>

* Optimize image qualities and a fix (alshedivat#762)

* blog tag-list

* optimize publication preview

* better compression

* optimize jpg project images

* reduce sizes of project images

* fix

* Skip Docker Image on Forked Images (alshedivat#767)

* Add Tags for Docker Images (alshedivat#754)

* Adds support for repositories (alshedivat#760)

* Add support for github repo cards

* add support for dark theme

* Add support for custom theme

* repositories

* fix

* make it simpler

* spcaing

* responsive fix

* adds support for usernames

* make it modular

* fix

* show icons

* cache_seconds

* fix

* Revert "cache_seconds"

This reverts commit a9dd4d5.

* add last line

* fix

* github only

* fix

* Add instructions

* Add `README.md` instructions

* Add `nav_order`

* Adds support for GA4 Google Analytics (alshedivat#727)

* Update `analytics.html`

* Update `config.yml`

* Update

* Update

* Added my webpage to the list (alshedivat#788)

Added my webpage to the list.

* Fix title spaces and a few links (alshedivat#789)

* fix title

* fix a few links

* add line

* Add website (alshedivat#802)

* Fix commas in author list (alshedivat#770)

* Support different colors for different kinds of publications in publication list (alshedivat#797)

* Add personal page (alshedivat#812)

* Update README.md

* add page (alshedivat#817)

* fix alshedivat#814 (alshedivat#818)

* fixe typos (alshedivat#823)

* Fix grammar (alshedivat#848)

* Update 2018-12-22-distill.md

* Update README.md

* Display booktitle for publications of type incollection (alshedivat#871)

* Adding Table of Contents to Readme file (alshedivat#876)

* Add dominikstrb's personal page (alshedivat#880)

Added a link to my personal website to the README

* Add Semantic Scholar social integration (alshedivat#879)

* add more social media (alshedivat#878)

alshedivat#877 is an explanation of the issue. The new icons include Kaggle,
LastFM, Spotify, Pinterest, Unsplash, Instagram, and Facebook, and you
can change their order.

* add multiple last names in bibliography (alshedivat#905)

Multiple last names can be defined to be highlighted in the bibliography
(alshedivat#904)

* fix bug where proceedings do not render (alshedivat#913)

* Improve info about theme colors (alshedivat#911)

* Add docker badges (alshedivat#888)

* Update README.md

* Set the margin according to the alignment selected (alshedivat#928)

As reported in alshedivat#927, the style of the profile class only considers a
left-margin regardless of the alignment option selected.
Thus, when the user changes the default alignment there is no
corresponding margin to match their selection.
My commit addresses this by enabling the corresponding margin for the
left or right alignment options

* Fix default highlighting (alshedivat#931)

The default setting `media="none"` disables code highlighting. This
works OK when we have `enable_darkmode: true` in `config.yml` as the
code handling the dark/light theme switching takes care of setting
`media=""` for the preferred theme.
However, setting `enable_darkmode: false` prevents importing `theme.js`
which in turn prevents said change thus the default highlighting stays
disabled.
Setting `media=""` by default enables the default highlighting when
`enable_darkmode` is false.

Fixes alshedivat#929

* Fixed missing year in title when in blog archive (alshedivat#921)

Fixed missing year in title when visualizing blog archive filtered by
year

Signed-off-by: George Araujo <george.gcac@gmail.com>

* Slugify tag and category links (alshedivat#947)

Fixes links to jekyll-archive pages when tag/category contains spaces.

* Update README.md (alshedivat#953)

added the link to the personal academic site I've started working on
using al-folio in the table

* Fixed broken link to distill-style blog post (alshedivat#957)

Updated README.md with the correct link to the distill-style blog post
example.

* Add a progress bar to show the scroll position (alshedivat#934)

This feature adds a horizontal bar under the top menu which tracks the
vertical scroll position. Such a feature can be useful to represent how
much is left to read on the current page more aesthetically.

As this is an optional feature, `enable_progressbar` must be set to
`true` in `_config.yml` to activate the functionality.

I am not the original author of this code. I just made it compatible
with the current version of the template at the time of this commit. The
original code was most likely authored by Pankaj Parashar in this
[post](https://css-tricks.com/reading-position-indicator/) made a few
years before the first inclusion in an `al-folio` site. Then, the code
was adapted for compatibility with the template at Anthony Plantanios'
site. Finally, I did
the last updates to have the code fit the new conventions used in the
project.

This was discussed in alshedivat#557

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>

* Enable progress bar by default

* Add WhatsApp to social integration (alshedivat#945)

* Add altmetric badges to paper (alshedivat#950)

[Altmetric](https://www.altmetric.com/) tracks social media and citation
activity for a paper. I added an option to add the altmeric id to a
paper's bib entry, which results in the altmeric badge for the paper
being displayed next to the other buttons. As an example, I added the
altmetric id for the Einstein, Podolsky & Rosen paper.

* Small stylistic fix

* Update README.md

* Add Docker-compose file for windows compatibility  (alshedivat#875)

This file makes it easier for windows users to use docker. (Closes alshedivat#829)

Previous to this commit, those who used Windows had to install Ubuntu
inside windows (via WSL) and run our commands. Now they can run it by
just typing `docker-compose up`.

> The main problem was that `./bin/dockerhub_run.sh` command was written
with `Bash` in mind and you had to change it a little bit to make it
compatible with windows `Powershell`. We shouldn't have two scripts.
This is why adding a `docker-compose.yml` file is necessary.

* Added Mastodon to social (alshedivat#974)

* Add Junshen's personal page (alshedivat#979)

Added a link to my personal website to the README.

* Add support for Disqus comments on distill posts (alshedivat#981)

Fixes alshedivat#980.

* Add backlink to verify mastodon (alshedivat#978)

* New update to GH Actions: Deprecating `save-state` and `set-output` commands (alshedivat#986)

Hi there

First of all, thanks for this amazing complete theme

Due to this warning which has been recently showed by Github,
`::set-output` will be deprecated and must be replaced with a new method


![image](https://user-images.githubusercontent.com/86428901/201933020-4a53d735-08b4-41d3-b38c-e16942fdd64e.png)

topic: [GitHub Actions: Deprecating save-state and set-output
commands](https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/)

Thanks

* Add Andreas Kuster's published webpage (alshedivat#991)

Thanks a lot for this very neat and professional template. This PR adds
my academic page to the Academics list

* Adds Telegram to social integrations (alshedivat#992)

* fix deploy script for `--user` (alshedivat#994)

Fixes alshedivat#820.

Explanation:
alshedivat#969 (comment)

* add ellisbrown.github.io reference (alshedivat#1008)

* Update README.md (alshedivat#1014)

Adding my webpage.

* ADD More Clear Explanations in README (alshedivat#1012)

* Add Container Name (alshedivat#1021)

* Adapt repo code to handle branches too (alshedivat#1003)

* Add support for giscus comments (alshedivat#1028)

adds support for comments on posts using https://giscus.app/

* Add interactive plotly example to distill post (alshedivat#1027)

* Hide the other opened box (Bib, Abs), if any (alshedivat#1002)

* Add Pre-commit Hook (alshedivat#801)

* Improve bib layout for thesis (alshedivat#920)

* add star to readme (alshedivat#1064)

* Add youtube as a social option (alshedivat#1007)

* Fix medium zoom on small devices (alshedivat#1084)

fixes alshedivat#1006

* Fix SRI hash (alshedivat#1087)

Sorry, forgot to change the SRI.

* Fix Docker Problem (alshedivat#1074)

* Adds Dimensions badge (alshedivat#1086)

This adds a dimension badge as requested in alshedivat#987.

This separates the the links from the badges, in case more badges need to be added in the future.

* Add news page (alshedivat#1085)

fixes alshedivat#993 

Also added links to news and publications from respective section
headers on the home page. Changed the colors of the header links to make
it consistent with the previous look.

* Added my star to README (alshedivat#1093)

Added my webpage link (⭐) to the table of `al-folio` users.

* Update favicon emoji length limit (alshedivat#1099)

Since, a image file will always contain a dot and a three letter
extension at least (ex: `.jpg`, `.png`, `.jpeg`, etc). Therefore we can
safely set the limit up to 4.

fixes alshedivat#1096

* fix distill hyperlink color (alshedivat#1113)

Make distill hyperlink color logic consistent with rest of the theme.

fixes alshedivat#1105

* fix: small typo (alshedivat#1143)

fix a small typo

* Use figure for bib entry preview (alshedivat#1152)

This makes sure that the image is resized per media type by imagemagick.
The result is still a bit too big (1400 width on desktop), but better
than nothing.

Signed-off-by: Zuhair AlSader <zalsader@hotmail.com>

* Add CogSci workshop to list of workshops in README (alshedivat#1170)

created a new row in the 'Workshops' section to add a workshop at Cogsci
2022 where we used this awesome template!
Thanks!

* Add star to academic portfolios (alshedivat#1178)

Adding my portfolio website to the list.

* Added george-gca academic site (alshedivat#1183)

Added new academic site

Signed-off-by: George Araújo <george.gcac@gmail.com>

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Update README.md to encourage people to use `Use this template`  (alshedivat#1167)

This PR changes README.md to encourage people to use `Use this template`
rather than `fork`.

### Differences between `Use this template` and fork
> - A new fork includes the entire commit history of the parent
repository, while a repository created from a template starts with a
single commit.
> - Commits to a fork don't appear in your contributions graph, while
commits to a repository created from a template do appear in your
contribution graph.
> - A fork can be a temporary way to contribute code to an existing
project, while creating a repository from a template starts a new
project quickly.
[Ref](https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)

### Cons
Possible con would be that it is harder to pull the new changes from
this repo to the users' repos. It does not seem like impossible to do so
but it will require additonal actions on the users end.
- https://github.com/orgs/community/discussions/23528
-
https://stackoverflow.com/questions/56577184/github-pull-changes-from-a-template-repository

---------

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Add OSF to social (alshedivat#1185)

* Update README.md

* Update 404.html wording for accessibility (alshedivat#1194)

* Added related posts section (alshedivat#1168)

* Add star to academic portfolios (alshedivat#1202)

* feat: add wikipedia social (alshedivat#1097)

I imagine more people have wikipedia accounts than wikidata entries
about them 😉

* OSF social link (alshedivat#1217)

Added missing "/" in the OSF link.

* Added information about using github action (alshedivat#1226)

By using this Github action it is possible to keep the derived
repository up-to-date with its template.

I am currently using this to keep my website up to date with the
template repository. An example of the PR this action creates can be
seen [here](george-gca/george-gca.github.io#13).

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Added github 🏆 section in repositories (alshedivat#1229)

Creates a new section with user trophies.

* Replace bin/deploy with GitHub Action (alshedivat#1234)

This PR updates `deploy.yml` to use the GitHub Action [Deploy to GitHub Pages](https://github.com/marketplace/actions/deploy-to-github-pages).

* Avoiding specific warning on Google Chrome (alshedivat#1268)

Avoids a warning that appears in the console when opening the site on Google Chrome

* Added related_posts false to the announcements front matter (alshedivat#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.

* Update README.md: added new profile (alshedivat#1263)

* Implemented copy code button feature (alshedivat#1267)

Implemented support for copy code button in code blocks (alshedivat#1262), also updated blog post about code to reflect it.

* Added more options to altmetric badge, changed to arxiv code first (alshedivat#1269)

* update readme + remove sponsorship info (alshedivat#1274)

majority of the recent improvements to al-folio have been truly driven
by a growing community of fans and contributors. this template has
gradually transformed from a low-key weekend project into a "public
good" of some sort used by thousands of people, university labs and
classes, and academic conference and workshops. as such, having personal
sponsorship info from the repository is no longer relevant.

as the community grows a bit further, we may have to think about
establishing some kind of governance around decisions of how al-folio is
supposed to evolve, which features to prioritize, and how to reward
contributors for their hard work. for now, these decisions will be made
by the project maintainers (active contributors are welcome to join the
team). and I'm all ears for proposals and suggestions!

* Fixed one-word typo in _config.yml (Non-Urgent) (alshedivat#1288)

* Update README - Add new profile (alshedivat#1285)

* Moved information about creating your repo to front (alshedivat#1298)

Moved information about using this template to the beginning of the
installation part, added a few more documentation links in it, fixed
some typos.

---------

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Fixed some typos in _config.yml and README.md (alshedivat#1306)

* Fix assets sitemap exclusion (alshedivat#1315)

* Implemented latest posts on about page (alshedivat#1307)

Adresses alshedivat#340

---------

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Implemented details tag for distill blog  (alshedivat#1321)

* Fix publication button spacing (alshedivat#1322)

* docs: add george-gca as a contributor for code (alshedivat#1323)

* Update README.md

---------

Signed-off-by: George Araujo <george.gcac@gmail.com>
Signed-off-by: Zuhair AlSader <zalsader@hotmail.com>
Signed-off-by: George Araújo <george.gcac@gmail.com>
Co-authored-by: Maruan <alshedivat@users.noreply.github.com>
Co-authored-by: Riddhiman Adib <adib2149@gmail.com>
Co-authored-by: Julian Streyczek <82290284+JulianStreyczek@users.noreply.github.com>
Co-authored-by: Sebastian Daza <sebastian.daza@gmail.com>
Co-authored-by: Maik Wöhl <maik.woehl@googlemail.com>
Co-authored-by: Amir Pourmand <pourmand1376@gmail.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@gmail.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>
Co-authored-by: Steven Rick <srick@eng.ucsd.edu>
Co-authored-by: José M. Requena Plens <joreple@upv.es>
Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>
Co-authored-by: Dinesh Natesan <AbstractGeek@users.noreply.github.com>
Co-authored-by: Edsuns <edsuns@qq.com>
Co-authored-by: Karim de Fombelle <karim.defombelle@gmail.com>
Co-authored-by: Xiaochen Zhu <42903201+zhxchd@users.noreply.github.com>
Co-authored-by: Nipuna Weerasekara <w.nipuna@gmail.com>
Co-authored-by: Julian Lehrer <jmlehrer@ucsc.edu>
Co-authored-by: Jun-Liang Lin <82939287+junliang-lin@users.noreply.github.com>
Co-authored-by: Ali Kuwajerwala <aliqk1603@gmail.com>
Co-authored-by: Scott Lee Chua <51027688+scottleechua@users.noreply.github.com>
Co-authored-by: Jack Lloyd-Walters <skiy@outlook.com>
Co-authored-by: Vanshaj Kerni <vkerni@ph.iitr.ac.in>
Co-authored-by: yyang768osu <yyang.ohiostate@gmail.com>
Co-authored-by: Viraj Thakkar <43007623+veedata@users.noreply.github.com>
Co-authored-by: Jiashu Xu <jiashuxu@usc.edu>
Co-authored-by: Kun Wu <tonywukun@qq.com>
Co-authored-by: Amala Wilson <amalachirayil@gmail.com>
Co-authored-by: Tirtharaj Dash <dashtirtharaj@gmail.com>
Co-authored-by: Guillaume Dalle <22795598+gdalle@users.noreply.github.com>
Co-authored-by: Tønnes Nygaard <tonnes.nygaard@gmail.com>
Co-authored-by: Carolina Carreira <carolinamcarreira@gmail.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar+git@gmail.com>
Co-authored-by: Manan Dey <manandey1@gmail.com>
Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Congcong Li <20706332+lufficc@users.noreply.github.com>
Co-authored-by: johanneshoerner <110042110+johanneshoerner@users.noreply.github.com>
Co-authored-by: Ioannis Mavromatis <44159802+ioannismavromatis@users.noreply.github.com>
Co-authored-by: gzwongkk <gzwongkk@gmail.com>
Co-authored-by: Leandro A. Bugnon <lbugnon@sinc.unl.edu.ar>
Co-authored-by: Tai D Nguyen <tainguyen7597@gmail.com>
Co-authored-by: Yavuz Alp Sencer ÖZTÜRK <28690608+alpsencer@users.noreply.github.com>
Co-authored-by: wristy <wristy8@gmail.com>
Co-authored-by: Lucas Hosseini <lucas.hosseini@gmail.com>
Co-authored-by: Dominik Straub <dominikstrb@mailbox.org>
Co-authored-by: Amir Hossein Kargaran <kargaranamir@gmail.com>
Co-authored-by: Josh Veitch-Michaelis <j.veitchmichaelis+github@gmail.com>
Co-authored-by: Carlos Morales <carlosmorales777@gmail.com>
Co-authored-by: George <31376482+george-gca@users.noreply.github.com>
Co-authored-by: Simmo Saan <simmo.saan@gmail.com>
Co-authored-by: Tyler Barna <57914086+tylerbarna@users.noreply.github.com>
Co-authored-by: Miroslav Suzara <miroslav.suzara@gmail.com>
Co-authored-by: Muhamamd Naufal Shidqi <nopal.sidqi@gmail.com>
Co-authored-by: bruno vianna <bruno@pobox.com>
Co-authored-by: Junshen Xu <junshenxu1996@gmail.com>
Co-authored-by: Alireza Dehghanzadeh <86428901+adehghanzadeh@users.noreply.github.com>
Co-authored-by: Andreas Kuster <20418060+andreaskuster@users.noreply.github.com>
Co-authored-by: Andrea Gasparini <andrea.gasparini11@gmail.com>
Co-authored-by: Ellis Brown <ellis.l.brown.ii@gmail.com>
Co-authored-by: Noman Bashir <noman.bashir.ahmad@gmail.com>
Co-authored-by: Fares Meghdouri <33158574+fm94@users.noreply.github.com>
Co-authored-by: Mohammad Qodrati <qodrati.m@gmail.com>
Co-authored-by: djherron <dave.herron1@gmail.com>
Co-authored-by: Philip Wong <4522927+p2635@users.noreply.github.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@protonmail.com>
Co-authored-by: Rodo-Singh <adityasinghdrdo@gmail.com>
Co-authored-by: ZhengLin Li <63448884+ZhengLin-Li@users.noreply.github.com>
Co-authored-by: Zuhair AlSader <zalsader@hotmail.com>
Co-authored-by: Kushin Mukherjee <kushinm11@gmail.com>
Co-authored-by: Divakar Verma <divakarv96@gmail.com>
Co-authored-by: Kotaro Suto <ng1a5ss43@gmail.com>
Co-authored-by: Mathias Micheel <49622130+buerviper@users.noreply.github.com>
Co-authored-by: Bashir Kazimi <kazimibashir907@gmail.com>
Co-authored-by: Allie <13716824+ChildishGiant@users.noreply.github.com>
Co-authored-by: Scott Lee Chua <scottleechua@gmail.com>
Co-authored-by: Do Hai Son <dohaison1998@gmail.com>
Co-authored-by: Douglas <48629993+DouglasKrouth@users.noreply.github.com>
Co-authored-by: Raphael Azorin <azorin.raphael@gmail.com>
Co-authored-by: Chen Chen <maker_cc@foxmail.com>
Co-authored-by: gaspardbb <40466739+gaspardbb@users.noreply.github.com>
passalis added a commit to passalis/passalis.github.io that referenced this issue Apr 22, 2023
* Update _config.yml

* Update bug_report.md

* Fix latex rendering issue in the bibliography entries (alshedivat#358)

* adds submenu in navigation bar. (fixes issue alshedivat#159) (alshedivat#334)

* adds submenu in navigation bar. (fixes issue alshedivat#159)

* Updated scss files to change hover animations on dropdown submenus, on both dark mode and light mode

* Revert "Change gitcdn link (alshedivat#234)" (alshedivat#364)

This reverts commit 0e4df83.

* minor updates to CONTRIBUTING and LICENSE, add website (alshedivat#365)

* Revert jekyll-scholar bibtex filters (alshedivat#381)

* Revert "Fix latex rendering issue in the bibliography entries (alshedivat#358)"

This reverts commit e328dc6.

* Update mathjax version to 3.2.0

* Add bibtex_filters explicitly to _config.yml

* add website (alshedivat#383)

* Add 'main' branch for newer GitHub repositories (alshedivat#389)

* add stackoverflow id (alshedivat#400)

* Add 404.html (alshedivat#412)

* add jekyll target blank plugin (alshedivat#404)

* add jekyll target blank

* Remove manual target blank from everywhere

* Update README.md

* Set ruby version to 3.0.2 in the deploy script

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* Add jekyll-diagrams (alshedivat#333)

* Add mermaid support via jekyll-diagrams

* Add mermaid install to deploy workflow

* Update README.md

* Update README.md

* Update README.md

* Add RSS icon to social.html (alshedivat#418)

* Add rss icon

* Add a blank line to make sure rss icon is always at the last

* Update README.md

* adds color transition support to li elements (alshedivat#434)

* Adding month to publication section (alshedivat#433)

* Update deploy.yml (alshedivat#436)

‘action’ is deprecated, change to ‘ruby’
https://github.com/ruby/setup-ruby

* Optimize Website Load Time (alshedivat#435)

* Place js files after body tag

* Add Analytics to the end of script

* Minor nits and fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Add support for responsive images (alshedivat#439)

* Added Jekyll-Archives (for tags, categories) and Jekyll site-map (alshedivat#346)

* Add webpage to academic pages list

* adding panelbear analytics

* added categories for projects and horizontal mode display for projects

* rewrote the code to ensure it works properly with current project definitions

* Style adjustments

* added blockquote format, jekyll-archives, tag, year archive pages, and reading time.

* added archive meta to blog posts list and individual posts.

* added sitemap

* stylistic modifications to jekyll-archive addition

* Minor fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Optimize dark theme (alshedivat#431)

* Optimize dark theme

* Fix-up

* Minor fixes

Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>

* Add best practices info to README

* Remove theming dependence on jquery

* Update README.md

* Update README.md

* remove extra space in profile image path (alshedivat#451)

* Revert "remove extra space in profile image path (alshedivat#451)" (alshedivat#468)

This reverts commit 0a8bfb4.

* Fix broken read_time in blog/index.html (alshedivat#469)

* Lighthouse enhancements (alshedivat#445)

* Add TOC to distill blog posts (alshedivat#470)

* Fix a small bug in _includes/responsive_img.html

Correctly fixes the issue mentioned in alshedivat#471.

* Add a website to list of academics websites (alshedivat#473)

* Switch to uing <picture> for responsive images

* Use WebP responsive images (alshedivat#498)

This PR replaces the jekyll-responsive-images with jekyll-imagemagick for responsive WebP images.

WebP images are much smaller compared to PNG and JPEG, faster to load and most of the modern browsers recommend it.

More information about WebP images: https://developers.google.com/speed/webp

* Delete assets/resized directory from GIT (alshedivat#440)

* Update 2015-10-20-math.md (alshedivat#514)

Typo

* Better SEO, OpenGraph, schema.org and clean generated code (alshedivat#481)

* Fix distill dark mode again (alshedivat#517)

* Correctly slugify distill TOC (alshedivat#519)

* Correctly slugify distill TOC

* Add special character to demo distill post's TOC

* Minor fixes (alshedivat#522)

* Fix distill collapsible Navbar (alshedivat#524)

* Update library versions (bootstap, jquery, fontawesome, academicicons, masonry, mdbootstrap) (alshedivat#521)

* added my website to readme examples (alshedivat#530)

* Add website to README.md (alshedivat#533)

* fixed title for og preview, otherwise its "blank" (alshedivat#531)

* fixed title for og preview, otherwise its "blank"

* Update _includes/metadata.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Add my personal website to Readme examples (alshedivat#535)

* Add my own site to the readme (alshedivat#545)

* Update README.md and LICENSE year (alshedivat#544)

* Change -webkit-transition to transition-property (alshedivat#540)

As per https://developer.mozilla.org/en-US/docs/Web/CSS/@media/-webkit-transition, webkit-transition feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes.

* Layout Spacing problem when footer_fixed: false (alshedivat#554)

* fix space

* Minor adjustments

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* Add Yang's webpage (alshedivat#559)

* Fix a small bug in news (alshedivat#560)

* Theme and responsiveness fixes (alshedivat#509)

* Dark themed cards

* Responsiveness fixes

* added dark stylesheet option

* highlight theme toggle

* added highlight function

* added highlight themes to assets/css

* offline highlight implementation

* Fixes for masonry

* Revert "added highlight themes to assets/css"

This reverts commit ee7cb76.

* Update `code syntax highlighting` to use jsdelivr CDN

* Project card responsiveness fixes

* added personal website to readme

veedata.github.io

* Reverted responsiveness chnages

* Minor adjustments

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* enable blog to redirect to asset (alshedivat#550)

* Add custom favicon if needed (alshedivat#386)

* Fix alshedivat#565

* mention K-Wu personal website in readme (alshedivat#575)

* Added amalawilson.com to the list of user samples (alshedivat#595)

* Added a star (alshedivat#617)

* Empty entrytype if not article or inproceedings (alshedivat#578)

For bibtex entries that are neither articles nor proceedings, the value `entrytype` carries over from the previous entry in the loop, leading to incorrect displays. This PR fixes that.

* Fix table colors in dark mode (alshedivat#624)

* Call bash on bin/deploy in github actions (alshedivat#625)

* Add support for external blog posts (alshedivat#647)

* Add support for external blog posts

* Cosmetic fixes

* Added documentation on publication buttons (alshedivat#651)

* Added documentation on publication buttons

* Added missing </details>

* Added bibtex filter to hide custom bibtex keywords from bib file output (alshedivat#652)

* Add a new star (alshedivat#667)

Add a start to list of academic personal webpages

* Delete `travis.yml` (alshedivat#665)

* Add `jekyll-minifier` (alshedivat#668)

* Remove obsolete plugins

* Add `jekyll-minifier`

* Add `JEKYLL_ENV=production`

* Add support for `nav_order` and Fix hardcoded navbar titles (alshedivat#664)

* Minor fixes for previous PR alshedivat#668 (alshedivat#672)

* Fix theme (alshedivat#697)

* fix theme

* fix theme

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>

* Add support for CV (alshedivat#628)

* Minor changes and fixes (alshedivat#726)

* Support for cicular image (alshedivat#728)

* Adds vertical scrollbar to news (alshedivat#729)

* Update Lighthouse PageSpeed Insights

* Adds support for bypassing GitHub Pages Jekyll processing (alshedivat#738)

* Adds support for preview images for publications (alshedivat#730)

* Adds support for publication teaser

* Adds an example for publication teaser

* Update example publication teaser

* Update size

* change `teaser` to `preview`

* Update _config.yml

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _layouts/bib.html

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Adds support for tag-list (alshedivat#734)

* Adds support for tag-list

* Update _sass/_base.scss

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Made tags optional

* Responsive deign for tag-list

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Fix typos in _layouts/about.html (alshedivat#739)

* add star (alshedivat#744)

* Change imagemagick optional to depend on one variable (alshedivat#745)

* Fix Previous PR (alshedivat#745) (alshedivat#746)

* Fix responsive image (alshedivat#748)

* fix

* base url

* Revert "base url"

This reverts commit 2e81d32.

* fix

* Better bundler caching for GitHub Actions (alshedivat#750)

* Better caching for GitHub Actions

* Update `actions/checkout` to `v3`

* docs: add alshedivat as a contributor for design, code (alshedivat#751)

* docs: update README.md [skip ci]

* docs: create .all-contributorsrc [skip ci]

* Update .all-contributorsrc

* Update README.md

* Update .all-contributorsrc

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>

* docs: add rohandebsarkar as a contributor for code (alshedivat#752)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>

* Add Dockerfile for easy installation on local machine  (alshedivat#532)

* docs: add pourmand1376 as a contributor for code (alshedivat#753)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>

* Update README.md

* Update README.md

* Update README.md

* Adds support `max_author_limit` (alshedivat#732)

* Adds support max author limit

* typo

* fix

* display all authors by default

* Added an example

* Added 'and' before the last author

* Improve hiding/showing more authors

* Add title text

Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>
Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Fix scripts (alshedivat#755)

* Include bootstrap bundle (alshedivat#756)

* Bootstrap js SRI fix (alshedivat#757)

* fix more authors bug (alshedivat#758)

* fix more authors bug

* fix

* add preview

Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@gmail.com>

* Optimize image qualities and a fix (alshedivat#762)

* blog tag-list

* optimize publication preview

* better compression

* optimize jpg project images

* reduce sizes of project images

* fix

* Skip Docker Image on Forked Images (alshedivat#767)

* Add Tags for Docker Images (alshedivat#754)

* Adds support for repositories (alshedivat#760)

* Add support for github repo cards

* add support for dark theme

* Add support for custom theme

* repositories

* fix

* make it simpler

* spcaing

* responsive fix

* adds support for usernames

* make it modular

* fix

* show icons

* cache_seconds

* fix

* Revert "cache_seconds"

This reverts commit a9dd4d5.

* add last line

* fix

* github only

* fix

* Add instructions

* Add `README.md` instructions

* Add `nav_order`

* Adds support for GA4 Google Analytics (alshedivat#727)

* Update `analytics.html`

* Update `config.yml`

* Update

* Update

* Added my webpage to the list (alshedivat#788)

Added my webpage to the list.

* Fix title spaces and a few links (alshedivat#789)

* fix title

* fix a few links

* add line

* Add website (alshedivat#802)

* Fix commas in author list (alshedivat#770)

* Support different colors for different kinds of publications in publication list (alshedivat#797)

* Add personal page (alshedivat#812)

* Update README.md

* add page (alshedivat#817)

* fix alshedivat#814 (alshedivat#818)

* fixe typos (alshedivat#823)

* Fix grammar (alshedivat#848)

* Update 2018-12-22-distill.md

* Update README.md

* Display booktitle for publications of type incollection (alshedivat#871)

* Adding Table of Contents to Readme file (alshedivat#876)

* Add dominikstrb's personal page (alshedivat#880)

Added a link to my personal website to the README

* Add Semantic Scholar social integration (alshedivat#879)

* add more social media (alshedivat#878)

alshedivat#877 is an explanation of the issue. The new icons include Kaggle,
LastFM, Spotify, Pinterest, Unsplash, Instagram, and Facebook, and you
can change their order.

* add multiple last names in bibliography (alshedivat#905)

Multiple last names can be defined to be highlighted in the bibliography
(alshedivat#904)

* fix bug where proceedings do not render (alshedivat#913)

* Improve info about theme colors (alshedivat#911)

* Add docker badges (alshedivat#888)

* Update README.md

* Set the margin according to the alignment selected (alshedivat#928)

As reported in alshedivat#927, the style of the profile class only considers a
left-margin regardless of the alignment option selected.
Thus, when the user changes the default alignment there is no
corresponding margin to match their selection.
My commit addresses this by enabling the corresponding margin for the
left or right alignment options

* Fix default highlighting (alshedivat#931)

The default setting `media="none"` disables code highlighting. This
works OK when we have `enable_darkmode: true` in `config.yml` as the
code handling the dark/light theme switching takes care of setting
`media=""` for the preferred theme.
However, setting `enable_darkmode: false` prevents importing `theme.js`
which in turn prevents said change thus the default highlighting stays
disabled.
Setting `media=""` by default enables the default highlighting when
`enable_darkmode` is false.

Fixes alshedivat#929

* Fixed missing year in title when in blog archive (alshedivat#921)

Fixed missing year in title when visualizing blog archive filtered by
year

Signed-off-by: George Araujo <george.gcac@gmail.com>

* Slugify tag and category links (alshedivat#947)

Fixes links to jekyll-archive pages when tag/category contains spaces.

* Update README.md (alshedivat#953)

added the link to the personal academic site I've started working on
using al-folio in the table

* Fixed broken link to distill-style blog post (alshedivat#957)

Updated README.md with the correct link to the distill-style blog post
example.

* Add a progress bar to show the scroll position (alshedivat#934)

This feature adds a horizontal bar under the top menu which tracks the
vertical scroll position. Such a feature can be useful to represent how
much is left to read on the current page more aesthetically.

As this is an optional feature, `enable_progressbar` must be set to
`true` in `_config.yml` to activate the functionality.

I am not the original author of this code. I just made it compatible
with the current version of the template at the time of this commit. The
original code was most likely authored by Pankaj Parashar in this
[post](https://css-tricks.com/reading-position-indicator/) made a few
years before the first inclusion in an `al-folio` site. Then, the code
was adapted for compatibility with the template at Anthony Plantanios'
site. Finally, I did
the last updates to have the code fit the new conventions used in the
project.

This was discussed in alshedivat#557

Co-authored-by: rohandebsarkar <rohandebsarkar@gmail.com>

* Enable progress bar by default

* Add WhatsApp to social integration (alshedivat#945)

* Add altmetric badges to paper (alshedivat#950)

[Altmetric](https://www.altmetric.com/) tracks social media and citation
activity for a paper. I added an option to add the altmeric id to a
paper's bib entry, which results in the altmeric badge for the paper
being displayed next to the other buttons. As an example, I added the
altmetric id for the Einstein, Podolsky & Rosen paper.

* Small stylistic fix

* Update README.md

* Add Docker-compose file for windows compatibility  (alshedivat#875)

This file makes it easier for windows users to use docker. (Closes alshedivat#829)

Previous to this commit, those who used Windows had to install Ubuntu
inside windows (via WSL) and run our commands. Now they can run it by
just typing `docker-compose up`.

> The main problem was that `./bin/dockerhub_run.sh` command was written
with `Bash` in mind and you had to change it a little bit to make it
compatible with windows `Powershell`. We shouldn't have two scripts.
This is why adding a `docker-compose.yml` file is necessary.

* Added Mastodon to social (alshedivat#974)

* Add Junshen's personal page (alshedivat#979)

Added a link to my personal website to the README.

* Add support for Disqus comments on distill posts (alshedivat#981)

Fixes alshedivat#980.

* Add backlink to verify mastodon (alshedivat#978)

* New update to GH Actions: Deprecating `save-state` and `set-output` commands (alshedivat#986)

Hi there

First of all, thanks for this amazing complete theme

Due to this warning which has been recently showed by Github,
`::set-output` will be deprecated and must be replaced with a new method


![image](https://user-images.githubusercontent.com/86428901/201933020-4a53d735-08b4-41d3-b38c-e16942fdd64e.png)

topic: [GitHub Actions: Deprecating save-state and set-output
commands](https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/)

Thanks

* Add Andreas Kuster's published webpage (alshedivat#991)

Thanks a lot for this very neat and professional template. This PR adds
my academic page to the Academics list

* Adds Telegram to social integrations (alshedivat#992)

* fix deploy script for `--user` (alshedivat#994)

Fixes alshedivat#820.

Explanation:
alshedivat#969 (comment)

* add ellisbrown.github.io reference (alshedivat#1008)

* Update README.md (alshedivat#1014)

Adding my webpage.

* ADD More Clear Explanations in README (alshedivat#1012)

* Add Container Name (alshedivat#1021)

* Adapt repo code to handle branches too (alshedivat#1003)

* Add support for giscus comments (alshedivat#1028)

adds support for comments on posts using https://giscus.app/

* Add interactive plotly example to distill post (alshedivat#1027)

* Hide the other opened box (Bib, Abs), if any (alshedivat#1002)

* Add Pre-commit Hook (alshedivat#801)

* Improve bib layout for thesis (alshedivat#920)

* add star to readme (alshedivat#1064)

* Add youtube as a social option (alshedivat#1007)

* Fix medium zoom on small devices (alshedivat#1084)

fixes alshedivat#1006

* Fix SRI hash (alshedivat#1087)

Sorry, forgot to change the SRI.

* Fix Docker Problem (alshedivat#1074)

* Adds Dimensions badge (alshedivat#1086)

This adds a dimension badge as requested in alshedivat#987.

This separates the the links from the badges, in case more badges need to be added in the future.

* Add news page (alshedivat#1085)

fixes alshedivat#993 

Also added links to news and publications from respective section
headers on the home page. Changed the colors of the header links to make
it consistent with the previous look.

* Added my star to README (alshedivat#1093)

Added my webpage link (⭐) to the table of `al-folio` users.

* Update favicon emoji length limit (alshedivat#1099)

Since, a image file will always contain a dot and a three letter
extension at least (ex: `.jpg`, `.png`, `.jpeg`, etc). Therefore we can
safely set the limit up to 4.

fixes alshedivat#1096

* fix distill hyperlink color (alshedivat#1113)

Make distill hyperlink color logic consistent with rest of the theme.

fixes alshedivat#1105

* fix: small typo (alshedivat#1143)

fix a small typo

* Use figure for bib entry preview (alshedivat#1152)

This makes sure that the image is resized per media type by imagemagick.
The result is still a bit too big (1400 width on desktop), but better
than nothing.

Signed-off-by: Zuhair AlSader <zalsader@hotmail.com>

* Add CogSci workshop to list of workshops in README (alshedivat#1170)

created a new row in the 'Workshops' section to add a workshop at Cogsci
2022 where we used this awesome template!
Thanks!

* Add star to academic portfolios (alshedivat#1178)

Adding my portfolio website to the list.

* Added george-gca academic site (alshedivat#1183)

Added new academic site

Signed-off-by: George Araújo <george.gcac@gmail.com>

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Update README.md to encourage people to use `Use this template`  (alshedivat#1167)

This PR changes README.md to encourage people to use `Use this template`
rather than `fork`.

### Differences between `Use this template` and fork
> - A new fork includes the entire commit history of the parent
repository, while a repository created from a template starts with a
single commit.
> - Commits to a fork don't appear in your contributions graph, while
commits to a repository created from a template do appear in your
contribution graph.
> - A fork can be a temporary way to contribute code to an existing
project, while creating a repository from a template starts a new
project quickly.
[Ref](https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)

### Cons
Possible con would be that it is harder to pull the new changes from
this repo to the users' repos. It does not seem like impossible to do so
but it will require additonal actions on the users end.
- https://github.com/orgs/community/discussions/23528
-
https://stackoverflow.com/questions/56577184/github-pull-changes-from-a-template-repository

---------

Co-authored-by: Maruan <alshedivat@users.noreply.github.com>

* Add OSF to social (alshedivat#1185)

* Update README.md

* Update 404.html wording for accessibility (alshedivat#1194)

* Added related posts section (alshedivat#1168)

* Add star to academic portfolios (alshedivat#1202)

* feat: add wikipedia social (alshedivat#1097)

I imagine more people have wikipedia accounts than wikidata entries
about them 😉

* OSF social link (alshedivat#1217)

Added missing "/" in the OSF link.

* Added information about using github action (alshedivat#1226)

By using this Github action it is possible to keep the derived
repository up-to-date with its template.

I am currently using this to keep my website up to date with the
template repository. An example of the PR this action creates can be
seen [here](george-gca/george-gca.github.io#13).

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Added github 🏆 section in repositories (alshedivat#1229)

Creates a new section with user trophies.

* Replace bin/deploy with GitHub Action (alshedivat#1234)

This PR updates `deploy.yml` to use the GitHub Action [Deploy to GitHub Pages](https://github.com/marketplace/actions/deploy-to-github-pages).

* Avoiding specific warning on Google Chrome (alshedivat#1268)

Avoids a warning that appears in the console when opening the site on Google Chrome

* Added related_posts false to the announcements front matter (alshedivat#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.

* Update README.md: added new profile (alshedivat#1263)

* Implemented copy code button feature (alshedivat#1267)

Implemented support for copy code button in code blocks (alshedivat#1262), also updated blog post about code to reflect it.

* Added more options to altmetric badge, changed to arxiv code first (alshedivat#1269)

* update readme + remove sponsorship info (alshedivat#1274)

majority of the recent improvements to al-folio have been truly driven
by a growing community of fans and contributors. this template has
gradually transformed from a low-key weekend project into a "public
good" of some sort used by thousands of people, university labs and
classes, and academic conference and workshops. as such, having personal
sponsorship info from the repository is no longer relevant.

as the community grows a bit further, we may have to think about
establishing some kind of governance around decisions of how al-folio is
supposed to evolve, which features to prioritize, and how to reward
contributors for their hard work. for now, these decisions will be made
by the project maintainers (active contributors are welcome to join the
team). and I'm all ears for proposals and suggestions!

* Fixed one-word typo in _config.yml (Non-Urgent) (alshedivat#1288)

* Update README - Add new profile (alshedivat#1285)

* Moved information about creating your repo to front (alshedivat#1298)

Moved information about using this template to the beginning of the
installation part, added a few more documentation links in it, fixed
some typos.

---------

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Fixed some typos in _config.yml and README.md (alshedivat#1306)

* Fix assets sitemap exclusion (alshedivat#1315)

* Implemented latest posts on about page (alshedivat#1307)

Adresses alshedivat#340

---------

Signed-off-by: George Araújo <george.gcac@gmail.com>

* Implemented details tag for distill blog  (alshedivat#1321)

* Fix publication button spacing (alshedivat#1322)

* docs: add george-gca as a contributor for code (alshedivat#1323)

* Update README.md

---------

Signed-off-by: George Araujo <george.gcac@gmail.com>
Signed-off-by: Zuhair AlSader <zalsader@hotmail.com>
Signed-off-by: George Araújo <george.gcac@gmail.com>
Co-authored-by: Maruan <alshedivat@users.noreply.github.com>
Co-authored-by: Riddhiman Adib <adib2149@gmail.com>
Co-authored-by: Julian Streyczek <82290284+JulianStreyczek@users.noreply.github.com>
Co-authored-by: Sebastian Daza <sebastian.daza@gmail.com>
Co-authored-by: Maik Wöhl <maik.woehl@googlemail.com>
Co-authored-by: Amir Pourmand <pourmand1376@gmail.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@gmail.com>
Co-authored-by: Maruan Al-Shedivat <maruan@genesistherapeutics.ai>
Co-authored-by: Steven Rick <srick@eng.ucsd.edu>
Co-authored-by: José M. Requena Plens <joreple@upv.es>
Co-authored-by: Maruan Al-Shedivat <alshedivat.maruan@gmail.com>
Co-authored-by: Dinesh Natesan <AbstractGeek@users.noreply.github.com>
Co-authored-by: Edsuns <edsuns@qq.com>
Co-authored-by: Karim de Fombelle <karim.defombelle@gmail.com>
Co-authored-by: Xiaochen Zhu <42903201+zhxchd@users.noreply.github.com>
Co-authored-by: Nipuna Weerasekara <w.nipuna@gmail.com>
Co-authored-by: Julian Lehrer <jmlehrer@ucsc.edu>
Co-authored-by: Jun-Liang Lin <82939287+junliang-lin@users.noreply.github.com>
Co-authored-by: Ali Kuwajerwala <aliqk1603@gmail.com>
Co-authored-by: Scott Lee Chua <51027688+scottleechua@users.noreply.github.com>
Co-authored-by: Jack Lloyd-Walters <skiy@outlook.com>
Co-authored-by: Vanshaj Kerni <vkerni@ph.iitr.ac.in>
Co-authored-by: yyang768osu <yyang.ohiostate@gmail.com>
Co-authored-by: Viraj Thakkar <43007623+veedata@users.noreply.github.com>
Co-authored-by: Jiashu Xu <jiashuxu@usc.edu>
Co-authored-by: Kun Wu <tonywukun@qq.com>
Co-authored-by: Amala Wilson <amalachirayil@gmail.com>
Co-authored-by: Tirtharaj Dash <dashtirtharaj@gmail.com>
Co-authored-by: Guillaume Dalle <22795598+gdalle@users.noreply.github.com>
Co-authored-by: Tønnes Nygaard <tonnes.nygaard@gmail.com>
Co-authored-by: Carolina Carreira <carolinamcarreira@gmail.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar+git@gmail.com>
Co-authored-by: Manan Dey <manandey1@gmail.com>
Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Congcong Li <20706332+lufficc@users.noreply.github.com>
Co-authored-by: johanneshoerner <110042110+johanneshoerner@users.noreply.github.com>
Co-authored-by: Ioannis Mavromatis <44159802+ioannismavromatis@users.noreply.github.com>
Co-authored-by: gzwongkk <gzwongkk@gmail.com>
Co-authored-by: Leandro A. Bugnon <lbugnon@sinc.unl.edu.ar>
Co-authored-by: Tai D Nguyen <tainguyen7597@gmail.com>
Co-authored-by: Yavuz Alp Sencer ÖZTÜRK <28690608+alpsencer@users.noreply.github.com>
Co-authored-by: wristy <wristy8@gmail.com>
Co-authored-by: Lucas Hosseini <lucas.hosseini@gmail.com>
Co-authored-by: Dominik Straub <dominikstrb@mailbox.org>
Co-authored-by: Amir Hossein Kargaran <kargaranamir@gmail.com>
Co-authored-by: Josh Veitch-Michaelis <j.veitchmichaelis+github@gmail.com>
Co-authored-by: Carlos Morales <carlosmorales777@gmail.com>
Co-authored-by: George <31376482+george-gca@users.noreply.github.com>
Co-authored-by: Simmo Saan <simmo.saan@gmail.com>
Co-authored-by: Tyler Barna <57914086+tylerbarna@users.noreply.github.com>
Co-authored-by: Miroslav Suzara <miroslav.suzara@gmail.com>
Co-authored-by: Muhamamd Naufal Shidqi <nopal.sidqi@gmail.com>
Co-authored-by: bruno vianna <bruno@pobox.com>
Co-authored-by: Junshen Xu <junshenxu1996@gmail.com>
Co-authored-by: Alireza Dehghanzadeh <86428901+adehghanzadeh@users.noreply.github.com>
Co-authored-by: Andreas Kuster <20418060+andreaskuster@users.noreply.github.com>
Co-authored-by: Andrea Gasparini <andrea.gasparini11@gmail.com>
Co-authored-by: Ellis Brown <ellis.l.brown.ii@gmail.com>
Co-authored-by: Noman Bashir <noman.bashir.ahmad@gmail.com>
Co-authored-by: Fares Meghdouri <33158574+fm94@users.noreply.github.com>
Co-authored-by: Mohammad Qodrati <qodrati.m@gmail.com>
Co-authored-by: djherron <dave.herron1@gmail.com>
Co-authored-by: Philip Wong <4522927+p2635@users.noreply.github.com>
Co-authored-by: Rohan Deb Sarkar <rohandebsarkar@protonmail.com>
Co-authored-by: Rodo-Singh <adityasinghdrdo@gmail.com>
Co-authored-by: ZhengLin Li <63448884+ZhengLin-Li@users.noreply.github.com>
Co-authored-by: Zuhair AlSader <zalsader@hotmail.com>
Co-authored-by: Kushin Mukherjee <kushinm11@gmail.com>
Co-authored-by: Divakar Verma <divakarv96@gmail.com>
Co-authored-by: Kotaro Suto <ng1a5ss43@gmail.com>
Co-authored-by: Mathias Micheel <49622130+buerviper@users.noreply.github.com>
Co-authored-by: Bashir Kazimi <kazimibashir907@gmail.com>
Co-authored-by: Allie <13716824+ChildishGiant@users.noreply.github.com>
Co-authored-by: Scott Lee Chua <scottleechua@gmail.com>
Co-authored-by: Do Hai Son <dohaison1998@gmail.com>
Co-authored-by: Douglas <48629993+DouglasKrouth@users.noreply.github.com>
Co-authored-by: Raphael Azorin <azorin.raphael@gmail.com>
Co-authored-by: Chen Chen <maker_cc@foxmail.com>
Co-authored-by: gaspardbb <40466739+gaspardbb@users.noreply.github.com>
smeznar pushed a commit to smeznar/smeznar.github.io that referenced this issue Apr 27, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
doraldoa pushed a commit to doraldoa/doraldoa.github that referenced this issue Jun 1, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
limyewjin pushed a commit to limyewjin/about that referenced this issue Jul 29, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
chowland pushed a commit to chowland/chowland.github.io that referenced this issue Aug 23, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
antchristou pushed a commit to antchristou/antchristou.github.io that referenced this issue Nov 20, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
mhnazeri pushed a commit to mhnazeri/mhnazeri.github.io that referenced this issue Dec 21, 2023
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
imprs added a commit to imprs/imprs.github.io that referenced this issue Feb 24, 2024
wangmagg pushed a commit to wangmagg/wangmagg.github.io that referenced this issue May 14, 2024
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
chertianser pushed a commit to chertianser/chertianser.github.io that referenced this issue Aug 8, 2024
…at#1266)

Added `related_posts: false` to the announcements front matter to avoid
errors like alshedivat#1203. Also included explanation in README FAQ section.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants