first post | Carlos Novo

This is a first post, mostly for testing puposes.
I will edit it later and replace it with something a little more special. Or delete it altogether.

I was looking for a place where I could share tutorials, perhaps with some math and code snippets, but I also wanted a website where content is easy to write, manage, export, migrate… Eventually I chose to write the posts in Markdown, and use Jekyll, a little like GitHub Pages.

Then I found this al-folio theme, which seems to fit my needs exactly. It is designed for academics, and contains a lot of fancy utilities, such as code highlighting, Latex math, charts, diagrams, etc.

I will leave some of the template examples right here, which showcase some of its best features:

Tabs and syntax highlighting

yaml
json

```
hello:
  - "whatsup"
  - "hi"
```
```
{
  "hello": ["whatsup", "hi"]
}
```

Code highlighting with line numbers


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

int main(int argc, char const *argv[])
{
string myString;
    cout << "input a string: ";
    getline(cin, myString);
    int length = myString.length();

    char charArray = new char * [length];

    charArray = myString;
    for(int i = 0; i < length; ++i){
        cout << charArray[i] << " ";
    }
    return 0;
}

Jupyter Notebooks

(Interactive) Charts

{
  "type": "line",
  "data": {
    "labels": [
      "January",
      "February",
      "March",
      "April",
      "May",
      "June",
      "July"
    ],
    "datasets": [
      {
        "label": "# of bugs",
        "fill": false,
        "lineTension": 0.1,
        "backgroundColor": "rgba(75,192,192,0.4)",
        "borderColor": "rgba(75,192,192,1)",
        "borderCapStyle": "butt",
        "borderDash": [],
        "borderDashOffset": 0,
        "borderJoinStyle": "miter",
        "pointBorderColor": "rgba(75,192,192,1)",
        "pointBackgroundColor": "#fff",
        "pointBorderWidth": 1,
        "pointHoverRadius": 5,
        "pointHoverBackgroundColor": "rgba(75,192,192,1)",
        "pointHoverBorderColor": "rgba(220,220,220,1)",
        "pointHoverBorderWidth": 2,
        "pointRadius": 1,
        "pointHitRadius": 10,
        "data": [
          65,
          59,
          80,
          81,
          56,
          55,
          40
        ],
        "spanGaps": false
      }
    ]
  },
  "options": {}
}

Custom block quotes:

This is a warning, for when you want to warn the user

This is a danger zone, and should be used carefully

Math

\(\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)\)

Tables

	ID	Item Name	Item Price

Diagrams

sequenceDiagram
    participant John
    participant Alice
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!

And post citations

Which you will find below.