Clever Geek Handbook

Data Science blog with fastpages

How to start your DS / ML / AI / Tech blog with a minimum of complexities associated with hosting and deploying this blog.



At the end of February 2020, the guys from fast.aiintroduced the world fastpagesto a blogging platform. I will note that it is fastpagesbased on Jekyll, about which there are many posts on HabrΓ©.



An example of a blog on the engine fastpagesis this blog .



The main distinguishing feature and advantage fastpagesis the supported post formats out of the box:



  • Jupyter notebooks (extension .ipynb);
  • Markdown files (extension .md);
  • Word files (extension .docx)


Thus, the blog author needs to save the post in any of the above formats in the appropriate directory:



  • './_notebooks/' for .ipynb;
  • './_posts/' for .md;
  • './_word/' for .docx.


And he will do the rest fastpages, according to its authors.



fastpages uses Github Pages for hosting and Github Actions to automate post publishing.



As I understand it, this fastpagesis a refinement of the Github Pages + bundle Jekyll, where you can immediately get the published post from the Jupyter laptop.



Creating a blog with fastpagesandGitHub



, fastpages.



fastpages:



  1. fastpages



    image
  2. pull request ( ~ 30 ), , .



    image
  3. pull request'a .








. ./_config.yml, :



  • title β€” , ;



  • description β€” , (, );



  • github_username β€” GitHub ;



  • github_repo β€” , GitHub, Google Colab Binder Jupyter ;



  • default_badges β€” GitHub, Google Colab Binder Jupyter . , , default_badges true false. , Binder, default_badges:



    default_badges:
github: true
binder: false
colab: true


  • url β€” , ;



  • baseurl β€” . /_config.yml ("Special Instructions for baseurl"). , ;



  • twitter_username β€” Twitter;



  • use_math β€” true, LaTeX;



  • show_description β€” . true;



  • google_analytics β€” Google Analytics;



  • pagination β€” , . 15. , , :

    image



  • show_tags β€” , :



    image



  • show_image β€” true . ( 2 ):



    image





.ipynb fastpages



  1. ( : .ipynb, .md .docx) (./_notebooks, ./_posts ./_word). 2020-05-26-DS-fastpages-blog.ipynb. Jekyll ( ).

    :

    • YYYY-MM-DD-;
    • , , .
  2. commit push GitHub master.
  3. GitHub . ~5 . Β«ActionsΒ» GitHub. workflow, push master:

    • Check Configurations β€” (, ), ;
    • CI β€” ;
    • GH Pages Status β€” .

      , .
  4. , , . .

    , fastpages .




, , . , , , fastpages.



Jupyter ( Markdown ) , / .



# "Title"
> "Awesome summary"

- toc: true
- branch: master
- badges: true
- comments: true
- author: Hamel Husain & Jeremy Howard
- categories: [fastpages, jupyter]


Markdown , , .. ---.



:



---
title: "Title"
description: "Awesome description"
toc: true
layout: post
categories: [markdown]
---


, , YAML . , : - title: "Deep learning: A tutorial"



YAML.



( ):



  • toc β€” true , Markdown ;
  • badges [notebooks only] β€” true Google Colab, Binder GitHub, ;
  • hide_github_badge [notebooks only] β€” true GitHub;
  • hide_colab_badge [notebooks only] β€” true Google Colab;
  • hide_binder_badge [notebooks only] β€” true Binder;
  • branch [notebooks only] β€” Jupyter Colab GitHub. : master;
  • comments β€” true ( );
  • author β€” true ;
  • categories β€” ( "Tags").
  • image β€” , . (Twitter) :

    • β€” images/figure.png;
    • /images ;
  • search_exclude β€” ( Search), , ;
  • hide β€” true , :

  • sticky_rank β€” , . , .




/ . ( ), , .



, Jupyter . , .



  • #hide β€” , ;
  • #hide_input β€” ;
  • #collapse-hide β€” , , ;
  • #collapse-show β€” , .


Altair



Altair . . .







Jupyter .

image





:



![](https://www.fast.ai/images/fastai_paper/show_batch.png "Credit: https://www.fast.ai/2020/02/13/fastai-A-Layered-API-for-Deep-Learning/")


:

image



, , ( ), ( ).





.





Youtube



Youtube :



> youtube: https://youtu.be/L0boq3zqazI


Twitter



Twitter.



, 



> twitter: https://twitter.com/jakevdp/status/1204765621767901185?s=20


:

image



LaTeX



Jupyter LaTeX . , , use_math _config.yml (. ).



LaTeX :



> $$L(\theta) = \frac{1}{N} \sum_i^N{(y_i - \hat{y_i})^2} \rightarrow \min_{\theta}$$


:



L(ΞΈ)=1Nβˆ‘iN(yi-yi^)2β†’minΞΈ





.



: > Warning: There will be no second warning!



image

: > Important: Pay attention! It's important.



image

: > Tip: This is my tip.



image

: > Note: Take note of this.



image



, .

, 



> Note: A doc link to [an example website: fast.ai](https://www.fast.ai/) should also work fine.


:

image



Emoji





   :robot:.


:

:robot:.



Emoji.





jupyter , Markdown . , :



{% raw %}For example, here is a footnote {% fn 1 %}.
And another {% fn 2 %}
{{ 'This is the footnote.' | fndetail: 1 }}
{{ 'This is the other footnote. You can even have a [link](https://fastpages.fast.ai/jupyter/2020/02/20/test.html#Footnotes)' | fndetail: 2 }}{% endraw %}


image



fastpages



fastpages nbdev jupyter , word .md . , /_notebooks, /_word /_posts, GitHub Actions c nbdev , .



fast_template β€” fastpages



, fast.ai fast_template, , Word Jupyter , . fastpages , , .



, fast_template , . - Github, git.







  • ;
  • Jupyter + :

    • ;
    • / ;
    • GIF-;
    • youtube .
  • Medium;
  • url;
  • badges GitHub, Binder, Google Colab, ;
  • ;
  • sticky_rank, ;
  • ;




  • , :

  • WYSIWYG (What You See Is What You Get):

    • Jekyll ;
    • ;
  • Jekyll , .
  • Jekyll git ;
  • Jupyter ;
  • , spell checker Jupyter .




fast.ai DS , , .



, git, Markdown Jupyter Notebook. , .



, , , . pull request , .



, .



DS/ML/AI













More articles:


All Articles