roquec.com | source | project

Welcome to the repository of my personal portfolio website roquec.com. The site is built using Jekyll, styled to imitate Visual Studio Code and hosted on GitHub Pages. For more information check out Portfolio Website Project.

Before running the website locally, follow these steps to prepare the environment.

1. Install Ruby latest version from Ruby Installer.
2. Choose MSYS2 and MINGW development tool chain option during installation.
3. Verify with installation ruby -v gem -v.

1. Clone portfolio repository.

git clone https://github.com/roquec/portfolio.git

2. Navigate to directory.

cd portfolio

3. Run install script to install bundler and gems.

.\scripts\install.ps1

Once your environment is set up, here's how to run and develop the site locally.

Execute serve script to build the site and serve it locally:

.\scripts\serve.ps1

This will generate the output in ./_site and update it when the source in src is modified.

The site will be available at http://127.0.0.1:4000/.

Note: changes to _config.yml file will not be automatically applied and require a manual re-build of the site

portfolio
  |-.github         -> Workflows and scripts used for GitHub Actions CI/CD pipeline
  |-_site           -> Autogenerated Jekyll output site directory
  |-scripts         -> Management scripts like 'serve.ps1' or 'install.ps1'
  |-src             -> Source code for Jekyll site
    |-_html         -> HTML layouts and includes
    |-_js           -> Javascript files to be bundled into scripts.js
    |-_sass         -> SASS files to be bundled into styles.css
    |-assets        -> Static assets like images, fonts...
    |-content       -> Content of the site like articles, projects and other posts
    |-_config.yml   -> Jekyll configuration file
    |-index.html    -> Root level files
    ...

This website is hosted on GitHub Pages, and it is released on every new change to the main branch. The build and release of the website is entirely done via GitHub Actions. The workflow that handles the release is ci-cd.yml.

This job does the following:

1. Execute set-placeholders.ps1 script to fill in data like the version information.
2. Build the Jekyll site.
3. Execute asset-hash.ps1 to generate hashes for all static assets and append them to the links.
4. Upload resulting artifact.

This job simply publishes the previously generated artifact (the _site folder) to GitHub Pages.

This job runs automated Lighthouse tests on the deployed site and publishes the results so we can have cool badges like this:

• Jekyll (site generator)
• Visual Studio Code (style reference)

This project is open sourced under the MIT License.

Got questions or feedback? Feel free to reach out at [email protected] or create an issue on GitHub.