Add project description

_config.yml

@@ -123,9 +123,7 @@ github: [metadata]
 # -----------------------------------------------------------------------------
 
 remove_HTML_comments: false
-
 beautify: false
-
 minify: false
 
 sass:

_includes/figure.html

@@ -7,7 +7,6 @@
       <source media="(max-width: {{ i }}px)" srcset="{{ path | relative_url }}-{{ i }}.webp" />
     {% endfor -%}
 
-    <!-- Fallback to the original file -->
     <img {% if include.class %}class="{{ include.class }}"{% endif %} src="{{ include.path | relative_url }}" {% if include.alt %}alt="{{ include.alt }}"{% endif %} {% if include.title %}title="{{ include.title }}"{% endif %} {% if include.zoomable %}data-zoomable{% endif %} />
 
   </picture>

_includes/head.html

@@ -1,21 +1,15 @@
         
-    <!-- Metadata, OpenGraph and Schema.org -->
     {% include metadata.html %}
 
-    <!-- Bootstrap & MDB -->
     <link href="https://cdn.jsdelivr.net/npm/bootstrap@{{ site.bootstrap.version }}/dist/css/bootstrap.min.css" rel="stylesheet" integrity="{{ site.bootstrap.integrity.css }}" crossorigin="anonymous">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/mdbootstrap@{{ site.mdb.version }}/css/mdb.min.css" integrity="{{ site.mdb.integrity.css }}" crossorigin="anonymous" />
 
-    <!-- Fonts & Icons -->
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@{{ site.fontawesome.version }}/css/all.min.css" integrity="{{ site.fontawesome.integrity }}" crossorigin="anonymous">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/academicons@{{ site.academicons.version }}/css/academicons.min.css" integrity="{{ site.academicons.integrity }}" crossorigin="anonymous">
-    <!-- <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Roboto+Slab:100,300,400,500,700|Material+Icons"> -->
     <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Roboto:400,500,700|Roboto+Slab:100,300,400,500,700|Material+Icons">
 
-    <!-- Code Syntax Highlighting -->
     <link rel="stylesheet" href="https://gitcdn.link/repo/jwarby/jekyll-pygments-themes/master/{{ site.highlight_theme }}.css" />
 
-    <!-- Styles -->
     {% if site.icon != empty -%}
     <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>{{ site.icon }}</text></svg>">
     {%- endif %}
@@ -24,7 +18,6 @@
 
     {%- if site.enable_darkmode %}
 
-    <!-- Dark Mode -->
     <script src="{{ '/assets/js/theme.js' | relative_url }}"></script>
     <script src="{{ '/assets/js/dark_mode.js' | relative_url }}"></script>
     {%- endif -%}

_includes/projects.html

@@ -1,5 +1,4 @@
 
-    <!-- _includes/projects.html -->
     <div class="grid-item">
       {% if project.redirect -%}
       <a href="{{ project.redirect }}">

_layouts/about.html

@@ -2,7 +2,6 @@
 layout: default
 ---
 
-<!-- about.html -->
       <div class="post">
         <header class="post-header">
           <h1 class="post-title">
@@ -35,9 +34,7 @@ layout: default
 
           {%- if page.social %}
 
-          <!-- Add some line breaks -->
           <!-- <br><br> -->
-          <!-- Social -->
           <div class="social">
             <div class="contact-icons">
             {% include social.html %}

_layouts/page.html

@@ -1,7 +1,7 @@
 ---
 layout: default
 ---
-<!-- page.html -->
+
         <div class="post">
 
           <header class="post-header">

_layouts/post.html

@@ -1,13 +1,11 @@
 ---
 layout: default
 ---
-<!-- _layouts/post.html -->
 {%- assign year = page.date | date: "%Y" -%}
 {%- assign tags = page.tags | join: "" -%}
 {%- assign categories = page.categories | join: "" -%}
 
 {% if page._styles %}
-<!-- Page/Post style -->
 <style type="text/css">
   {{ page._styles }}
 </style>

_pages/projects.md

@@ -8,15 +8,12 @@ display_categories: [university, personal]
 horizontal: false
 ---
 
-<!-- pages/projects.md -->
 <div class="projects">
 {%- if site.enable_project_categories and page.display_categories %}
-  <!-- Display categorized projects -->
   {%- for category in page.display_categories %}
   <h2 class="category">{{ category }}</h2>
   {%- assign categorized_projects = site.projects | where: "category", category -%}
   {%- assign sorted_projects = categorized_projects | sort: "importance" %}
-  <!-- Generate cards for each project -->
   {% if page.horizontal -%}
   <div class="container">
     <div class="row row-cols-2">
@@ -35,9 +32,7 @@ horizontal: false
   {% endfor %}
 
 {%- else -%}
-<!-- Display projects without categories -->
   {%- assign sorted_projects = site.projects | sort: "importance" -%}
-  <!-- Generate cards for each project -->
   {% if page.horizontal -%}
   <div class="container">
     <div class="row row-cols-2">

_projects/BottlerOS.md

@@ -0,0 +1,60 @@
+---
+layout: page
+title: BottlerOS
+description: Basic operative system.
+img:
+importance: 1
+github: https://github.com/slococo/BottlerOS
+category: university
+---
+
+# BottlerOS
+
+BottlerOS es un sistema operativo.
+
+## Tabla de contenidos
+* [Requisitos](#requisitos)
+* [Compilación](#compilación)
+* [Ejecución](#ejecución)
+* [Testeos](#tests)
+
+## Requisitos <a name="requisitos"></a>
+
+Debe instalar nasm, qemu, gcc, make. Estos se encuentran disponibles en el repositorio de la vasta mayoría de distribuciones de Linux/macOS.
+
+Debian/Ubuntu: `apt install nasm qemu gcc make`\
+macOS (con [homebrew](https://brew.sh/)): `brew install nasm qemu gcc make`
+
+Si tiene otra distribución consulte cómo hacerlo.
+
+## Compilación <a name="compilación"></a>
+
+Para compilar todos los archivos se debe ejecutar el script `build.sh` (desde la carpeta raíz del proyecto). Note que usted podrá pasarle como argumento `buddy` si desea compilar con este memory manager (por defecto no compilará con este). Además, si quiere probar el OS con el teclado en español lo podrá hacer pasandole como argumento `spanish`. Por último, el parámetro `free` liberará la memoria (que haya sido obtenida mediante `malloc`) al terminar o hacer `kill` de un proceso.   
+
+```bash
+./build.sh
+```
+
+Este script hará un `make` en la carpeta de `Toolchain` y luego un `make` en la carpeta `root` del proyecto. Luego, dependiendo del parámetro ingresado hará: `make all`, `make spanish`, `make buddy` o `make free`.
+
+## Ejecución <a name="ejecución"></a>
+
+Ahora, usted podrá ejecutar BottlerOS haciendo:
+
+```bash
+./run.sh
+```
+
+Si, en su defecto, usted quiere correr el OS desde windows lo podrá hacer con:
+
+```bash
+./run.bat
+```
+
+## Testeos <a name="tests"></a>
+
+En orden de realizar un análisis estático del sistema usted debe tener instalado [cppcheck](http://cppcheck.net/) y [pvs-studio](https://pvs-studio.com/). Luego, puede correrlos con:
+
+```bash
+make test
+```

_projects/u1_project.md

@@ -1,10 +0,0 @@
----
-layout: page
-title: BottlerOS
-description: Basic operative system.
-img:
-importance: 1
-github: https://github.com/slococo/BottlerOS
-category: university
----
-