al-folio: Deployment failure on github

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 A clear and concise description of what the bug is.

To Reproduce Steps to reproduce the behavior:

  1. Go to ‘…’
  2. Click on ‘…’
  3. Scroll down to ‘…’
  4. See error

Expected behavior A clear and concise description of what you expected to happen.

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

System (please complete the following information):

  • OS: [e.g. iOS]
  • Browser (and its version) [e.g. chrome, safari]
  • Jekyll version [e.g. 3.8.7]
  • Ruby version [e.g. 2.6.5]

Additional context Add any other context about the problem here.

I worked on setting up this project for the whole day but cannot make it. I can successfully running the project on my local machine but when I comment and push my modification to Github, there is always something wrong in the ‘Action’. As a result, I cannot deploy.

One example is:

Liquid Exception: Liquid syntax error (line 5): Unknown tag ‘twitter’ in /github/workspace/_posts/2020-09-28-twitter.md /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/document.rb:23:in unknown_tag': Liquid syntax error (line 5): Unknown tag 'twitter' (Liquid::SyntaxError) from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/document.rb:11:in block in parse’ from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/block_body.rb:32:in parse' from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/document.rb:10:in parse’ from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/document.rb:5:in parse' from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/template.rb:132:in parse’ from /usr/local/bundle/gems/liquid-4.0.3/lib/liquid/template.rb:116:in parse' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/liquid_renderer/file.rb:13:in block in parse’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/liquid_renderer/file.rb:49:in measure_time' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/liquid_renderer/file.rb:12:in parse’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/renderer.rb:121:in render_liquid' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/renderer.rb:79:in render_document’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/renderer.rb:62:in run' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:479:in render_regenerated’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:464:in block (2 levels) in render_docs' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:463:in each’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:463:in block in render_docs' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:462:in each_value’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:462:in render_docs' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:191:in render’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/site.rb:71:in process' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/command.rb:28:in process_site’ from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/commands/build.rb:65:in build' from /usr/local/bundle/gems/jekyll-3.9.2/lib/jekyll/commands/build.rb:36:in process’ from /usr/local/bundle/gems/github-pages-227/bin/github-pages:70:in block (3 levels) in <top (required)>' from /usr/local/bundle/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in block in execute’ from /usr/local/bundle/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in each' from /usr/local/bundle/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in execute’ from /usr/local/bundle/gems/mercenary-0.3.6/lib/mercenary/program.rb:42:in go' from /usr/local/bundle/gems/mercenary-0.3.6/lib/mercenary.rb:19:in program’ from /usr/local/bundle/gems/github-pages-227/bin/github-pages:6:in <top (required)>' from /usr/local/bundle/bin/github-pages:23:in load’ from /usr/local/bundle/bin/github-pages:23:in `<main>’ Globbed Scope Path: assets/js/dark_mode.js Rendering: _posts/2020-09-28-twitter.md Pre-Render Hooks: _posts/2020-09-28-twitter.md Rendering Liquid: _posts/2020-09-28-twitter.md github-pages 227 | Error: Liquid syntax error (line 5): Unknown tag ‘twitter’

Besides when I delete the 2020-09-29-twitter.md, there will be:

github-pages 227 | Error: Liquid syntax error (/github/workspace/_includes/selected_papers.html line 4): Unknown tag ‘bibliography’ included.

I really want to know what’s happening and how to fix them. I have tried both the docker and local machine way on my Windows system but both not work.

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Reactions: 8
  • Comments: 22 (1 by maintainers)

Most upvoted comments

I am running into a very similar issue.

The error I am running into is: Liquid syntax error (line 6): Unknown tag ‘bibliography’

I don’t think qomhmd’s answer is relevant here, as this error occurs during the pages build workflow, which is a precondition for creating the gh-pages folder in the first place

As @rohandebsarkar mentioned, you need to enable read & write permission under Action -> General -> Workflow permissions. Wait for a few minutes and let the action complete, then in the Settings of your repository, in the Pages section, set the branch to gh-pages.

@rohandebsarkar Thanks a lot, literally life saver !

Tried pretty much all the solutions posted here, deployment fails for fresh forks. The error for me is :

github-pages 227 | Error: Liquid syntax error (line 5): Unknown tag 'twitter'

Per https://github.com/alshedivat/al-folio#deployment under the subtitle “To enable automatic deployment”:

  1. Go to your project > Settings > Pages
  2. Under “Build and deployment” set source to deploy from a branch and branch to gh-pages