Xmartlabs Blog

The purpose of this blog is to showcase some insight into our work and share data and tips related to the projects we tackle. We will also keep it updated with info and news about Xmartlabs.

Local setup
Featured posts

Setup

This blog was built using Jekyll, a simple, extendable and static site generator. To set it up on your machine you have two options:

Local setup

Clone the project into your machine: git clone git@github.com:xmartlabs/blog.git
Install Ruby 2.6.3 (you can use rbenv)
Install Jekyll and bundler in this Ruby version by running: gem install jekyll bundler
Go to the folder for this repository and build the site with jekyll serve or jekyll serve --host=0.0.0.0 (if you want to use it from your phone or other machine)
Now browse to http://localhost:4000 or http://YOUR-IP:4000

Local setup using docker

Clone the project into your machine: git clone git@github.com:xmartlabs/blog.git
Install docker and docker-compose
Go to the folder for this repository and build the site with docker-compose up

Test your blogpost

If you want to test your blogpost you have two options to try it out:

Using the Staging environment

The blog has a staging environment hosted in blog-staging.xmartlabs.com, which can be used to test the blogposts you’re working on. That environment is the result of deploying the last commit of the staging GitHub repository. So, if you want to deploy a new staging version you have to add the staging GitHub repository remote url and push the commit that you want to deploy.

git remote add staging git@github.com:xmartlabs/blog-staging.git # Only the first time
git push staging

Make blogpost accessible but not listed in blog.xmatlabs.com allow

Make sure show: true is not present if you want to hide your from main blog post list.

---
layout: post
title: "Agile iOS development workflow using Fastlane & Bitrise"
date: 2020-04-01 10:00:00
author: Martin Barreto
tags: [Xmartlabs, CI, fastlane, bitrise, iOS]
author_id: mtnBarreto
featured_image: /images/ios-fastlane-ci/featured.png
show: true
---

IMPORTANT: Newest blogposts will be shown on the featured section.

Featured posts

Last 3 posts are the featured posts. You need to set the following custom variables in its front matter: These may take one of the following values: - top position: the image size needs to be around 574x385px - 2 blogposts in a secondary level position: the image size needs to be around 706x187px

featured_image: /images/my-new-post/featured.png Remember to place the image inside the post's folder. A different name and format can be used, just assign the correct path to the variable.

How to crosspost a post to medium

We need to add crosspost_to_medium: true then set up MEDIUM_USER_ID and MEDIUM_INTEGRATION_TOKEN env variables in your computer.

you can check if the variables are properly set up by printenv | grep MEDIUM

Next time you build or serve the locally the blog it will be sent to medium as draft story.

What to do if the CSS changes aren't applied when releasing?

Sometimes changes to the CSS aren't applied once the page is released to GitHub Pages, this means the old CSS will be used causing different problems that can't be reproduced locally.

To force GitHub to load the new CSS you can edit this line at head.html:

<link rel="stylesheet" href="{{ "/css/main.css" | relative_url }}">

So far adding (or removing, when it was already there) an id parameter to the /css/main.css url has worked.

<link rel="stylesheet" href="{{ "/css/main.css?id=12345" | relative_url }}">

mirland/blog