[fastpages] Deprecating fastpages in favor of Quarto

nbdev
4

@hamelsmu have you created any tutorial on how to start using quarto to create blogs on github pages?

5

You can read the Quarto docs. I’ve linked to some useful pages in the nbdev docs I shared

4 Likes
6

Can we use quarto with kaggle’s jupiter notebook ?

7

Could you share more about how you’d like to use this? You can download the notebook as an .ipynb file (in the Kaggle notebook edtir: File > Download Notebook) which works with Quarto.

8

Thanks for providing Quarto as an easy-to-use blogging platform. As a fast.ai-beginner, I took the advice to start blogging about my learning journey.

Setting up my blog was not really hard, but it took some time. To hopefully provide some shortcuts, I created a quick tutorial on how to setup a blog with Quarto and how to leverage jupyter notebooks for blogging. Happy blogging!

13 Likes
9

@chrwittm Thank you so much for your post. I am also a fast.ai beginner and starting a blog seems like the best way to integrate into the data science community, and document the learning journey ahead. This is my first ever blog :slight_smile:

1 Like
10

@SJB137 I am glad I could help you start your blog!

1 Like
11

Hi, after you’ve downloaded quarto, you can use this guide to start your blog.

Hope it helps!

4 Likes
12

Thanks @chrwittm @afshan22 – I’ve sent your posts to the CEO of RStudio and suggested he consider using them as a role model for an official Quarto tutorial :slight_smile:

7 Likes
13

It makes me so happy to see everyone’s blogs, and you’re all putting out such valuable content too! :slight_smile: Should we make a “share your quarto blog” topic?

3 Likes
14

Yes this is a great idea :smiley: Esp because we can all learn each others customizations and other things they’re doing :slight_smile: (And we can seperate the fastai projects and blogs)

2 Likes
15

Thanks a lot @afshan22 ! Really wonderful guide.

1 Like
16

@hamelsmu , should we worry if, when we run the second line in the Migration guide, i.e., the line that reads

quarto install extension quarto-ext/video

, that it responds with the message:

Extension not found in local or remote sources

?

Here’s a full log of activities up to and including that point:

$ git clone https://github.com/drscotthawley/blog_quarto.git
Cloning into 'blog_quarto'...
warning: You appear to have cloned an empty repository.
$ cd blog_quarto/
$ quarto create-project --type website:blog .
Creating project at /Users/shawley/github/blog_quarto:
  - Created _quarto.yml
  - Created .gitignore
  - Created index.qmd
  - Created posts/welcome/index.qmd
  - Created posts/post-with-code/index.qmd
  - Created about.qmd
  - Created styles.css
  - Created posts/_metadata.yml
$ quarto install extension quarto-ext/video
Extension not found in local or remote sources

Thanks!

17

That extension recently got merged with Quarto itself; that is, it’s now a built-in feature of Quarto. So it doesn’t need to be or can’t be installed anymore.

2 Likes
18

Publishing my blog at https://chrwittm.github.io/ used to be very easy via

quarto publish gh-pages

Today, however, I get the following error (no obvious change to my setup):

fatal: 'gh-pages' is already checked out at /mnt/c/Users/chrwi/OneDrive/Dokumente/GitRepos/chrwittm.github.io/bc75ca74

I am a git-newbie, tried google it, but none of the result yielded working results.
Do you have any advice how to get rid of this checkout?
Thanks for your help!

Solved: I found a solution which actually makes a lot of sense to me now: You can easily re-build your Quarto blog from the main branch of your repo: For more details check out this blog post - existence proof that my blog is back :wink:

1 Like
19

Thanks for this post and the migration guide. It was really helpful in helping me migrate my fastpages blog to quarto!

A couple pieces of feedback on the migration guide in the hopes of helping others:

  • The “pip install -U git+https://github.com/fastai/nbdev” step you mention in a reply here is essential; it would be nice to add this to the migration guide.
  • The instructions about moving the images are incorrect. I needed to end up with all of the images in the directory “posts/images” I believe you can just do: “cp -r …/blog/images posts/” and have things work
20

Hi,

My fastpages blog (github repo here) does not build anymore, because of an error in Jekyll I don’t really manage to fix…

  Liquid Exception: Invalid syntax for include tag. File contains invalid characters or sequences: social-icons/.svg Valid syntax: {% include file.ext param='value' param2='value' %} in assets/minima-social-icons.liquid
      Remote Theme: Cleaning up /tmp/jekyll-remote-theme-20221225-1-10joxn8
/usr/gem/gems/jekyll-4.1.1/lib/jekyll/tags/include.rb:59:in `validate_file_name': Invalid syntax for include tag. File contains invalid characters or sequences: (ArgumentError)

Since I had this error, I tried to migrate to Quarto using the tutorial mentioned in this post, but didn’t manage to get my .docx articles to be converted.

Would be grateful for help on one of these directions :).

EDIT: someone (not on this forum) found a solution to this problem! See below

1 Like
21

I’m still trying to migrate my fp posts to quarto, but it’s tedious. It’s fine that fastpages is no longer maintained, but why do the fastpages no longer render as nicely? I.e. no more latex support https://jhmartel.github.io/fp/

22

Hello @_JHM, @Sayak has likely solved the problem you are facing. Read about it here: Fastpages site not rendering properly - #2 by Sayak

1 Like
25

For a little while I’d maintained two different blogs (old fastpages and new quarto), but this morning I managed to consolidate them, and got all the interactive 3D plots and animations working. :partying_face: