blog/README.md

2.8 KiB

samuel.forestier.app

What a personal Jekyll blog 💯

Deploy it locally

Fetch the sources

git clone git@git.forestier.app:HorlogeSkynet/blog.git
cd blog/

Install requirements

apt install -y g++ make gem ruby-dev zlib1g-dev

Provision Ruby environment

gem install \
    --no-document \
    --install-dir .gem/ \
    jekyll \
    jemoji \
    jekyll-seo-tag \
    jekyll-sitemap \
    jekyll-redirect-from \
    jekyll-mentions \
    jekyll-paginate-v2

Run the development server

export GEM_HOME=.gem; $GEM_HOME/bin/jekyll serve

Congratulations, you can now go to http://127.0.0.1:4000/ 🎉

How to contribute ?

Project architecture

  • Posts are placed under _posts/ folder, and their respective images under _img/ folder

  • Styles and scripts assets are respectively under css/ and js/ folders

Cool stuffs available here

  • Post last modified date :

    ---
    last_modified_at: 2012-12-12 12:12
    ---
    
  • Disable comments section per post with :

    ---
    comments: false
    ---
    
  • Publish a post as draft (not referenced anywhere) :

    ---
    draft: true
    sitemap: false
    ---
    
  • Set a static link to a post or a page (in addition to its default permalink) :

    ---
    redirect_from: /my-cool-link
    ---
    
  • Add a reference to a GitHub user profile within a post or a page :

    This is a pretty **cool post** written by @HorlogeSkynet !
    
  • Create an images gallery :

    {% include gallery.html URIs='your-post-name_1.png;your-post-name_2.jpg;your-post-name_3.jpeg' %}
    
  • Add a video withing an <iframe> tag :

    {% include video.html URL='https://your.video.provider/video_id' %}
    
  • Add a music from SoundCloud or Spotify :

    {% include soundcloud.html track_id='your_track_id' %}
    <!-- ... -->
    {% include spotify.html track_id='your_track_id' %}
    
  • Add a right-padding to a FontAwesome icon (automatically left-padded) :

    <i class="fas fa-forward right"></i>
    

Acknowledgments

This website is built upon :

Thanks (again !) to @NAERNON for its wonderful favicon.