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
   
   
   
   
2. pull request ( ~ 30 ), , .
   
   
   
   
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. , , :
  
  

  
  
  

• show_tags — , :
  
  
  
  

  
  
  

• show_image — true . ( 2 ):
  
  
  
  

  
  
  

.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 , :
  
  
  • permalinks ;
  • search_exclude true, ( Search);
• sticky_rank — , . , .

/ . ( ), , .

, Jupyter . , .

• #hide — , ;
• #hide_input — ;
• #collapse-hide — , , ;
• #collapse-show — , .

Altair

Altair . . .

Jupyter .

:

![](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/")

:

, , ( ), ( ).

.

Youtube

Youtube :

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

Twitter

Twitter.

,

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

:

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(\theta) = \frac{1}{N} \sum_i^N{(y_i - \hat{y_i})^2} \rightarrow \min_{\theta}$$

.

: > Warning: There will be no second warning!





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





: > Tip: This is my tip.





: > Note: Take note of this.

, .

,

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

:

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 %}

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, ;
• ;

• , :
  
  
  • permalinks;
  • ;
  • , , (, ) , - .
• 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

• fastpages by Scott H. Hawley;
• ;
• Andrej Karpathy github.io, medium;
• Machine Learning Mastery by Jason Brownlee;

• Fast.ai + fastpages blog;
• Airbnb;
• Uber;
• OpenAI;
• DeepMind;
• Nvidia + AI podcast;
• Microsoft AI blog + ML devblogs

• fastpages;
• Introducing fastpages;
• , .ipynb ;
• fast_template + fast.ai;
• Project home pagenbdev + repository + forum ;
• A fairly broad overview of blog engines;
• More blogs [ 1 , 2 ];