Skip to content

jekyll_setup.md

Latest commit

 

History

History
59 lines (46 loc) · 3.98 KB

jekyll_setup.md

File metadata and controls

59 lines (46 loc) · 3.98 KB

Setting up Jekyll for Serving the Site

  1. Install Ruby:
    Jekyll is written in Ruby, so you need a recent version of Ruby installed on your system. You can download Ruby from ruby-lang.org or use a version manager like rbenv or RVM.

  2. Install Bundler and Jekyll:
    Once Ruby is installed, open your terminal (or command prompt) and run:

    gem install bundler jekyll

  3. Create a New Jekyll Site:
    Navigate to the directory where you want your site and run:

    jekyll new portfolio-site
cd portfolio-site

    This command creates a new directory named portfolios-site with a default structure (including a _layouts folder, _posts folder, etc.).

  4. Customize Your Layout:

    • Open the _layouts/default.html file to edit your overall template (including the <head>, navbar, footer, etc.).
    • Use Liquid templating syntax (e.g., {{ content }}) to designate where page-specific content will go.

  5. Create Pages:
    Create individual pages (for example, index.md, about.md, etc.) in the root directory. At the top of each file, add a front matter block:

    ---
layout: default
title: Home
---

    Then add your page content below.

  6. Build and Serve Your Site:
    From the project directory, run:

    bundle exec jekyll serve

    This will build your site and serve it locally (typically at http://localhost:4000).

  7. Deployment:
    Once you’re happy with your site, you can deploy the static files (found in the _site directory after a build) to any static hosting provider (e.g., GitHub Pages, Netlify, Vercel).

Summary

  • Installation: Ruby → Bundler & Jekyll via gem install
  • Site Creation: jekyll new portfolio-site
  • Customization: Edit _layouts/default.html and add pages with front matter.
  • Local Development: bundle exec jekyll serve
  • Deployment: Upload the static files from the _site folder.

This setup produces full, SEO-friendly static HTML pages while allowing you to manage your layout with a templating language. If you prefer another static site generator (like Hugo, Eleventy, etc.), the setup process is similar—install the tool, create a new project, and customize templates.

setx PATH "C:\Ruby33-x64\bin;C:\Python312\Scripts\;C:\Python312\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\iCLS\;C:\Program Files\Intel\Intel(R) Management Engine Components\iCLS\;C:\Program Files\Intel\WiFi\bin\;C:\Program Files\Common Files\Intel\WirelessCommon\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files\Intel\Intel(R) Management Engine Components\IPT;C:\Users\bento\AppData\Local\Programs\Python\Python310;C:\Users\bento\AppData\Local\Programs\Python\Python310\Scripts;C:\Program Files\dotnet\;C:\Program Files\Git\cmd;C:\Program Files\ISC BIND 9\bin;C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe;C:\ProgramData\chocolatey\bin;C:\ProgramData\chocolatey\lib\ffmpeg\tools\ffmpeg\bin;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;%SYSTEMROOT%\System32\OpenSSH\;C:\Program Files\MySQL\MySQL Shell 8.0\bin\;C:\Users\bento\AppData\Local\Programs\Quarto\bin;C:\Users\bento\miniconda3;C:\Users\bento\miniconda3\Library\mingw-w64\bin;C:\Users\bento\miniconda3\Library\usr\bin;C:\Users\bento\miniconda3\Library\bin;C:\Users\bento\miniconda3\Scripts;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\170\Tools\Binn\;C:\Program Files\PuTTY\;C:\Users\bento\AppData\Local\Programs\Quarto;C:\Users\bento\AppData\Local\Programs\Microsoft VS Code\bin;C:\Users\bento\.dotnet\tools;C:\Users\bento\AppData\Roaming\TinyTeX\bin\windows;C:\Program Files\Graphviz\bin\;C:\Users\bento\AppData\Local\Microsoft\WindowsApps;"