DEV Community

Cover image for Documenta tu Evolución Profesional
Camilo for JavaScript Chile

Posted on • Updated on

Documenta tu Evolución Profesional

Un sitio web personal es un gran aliado para documentar nuestro camino y evolución en la industria I.T.

Github Es Insuficiente

Muchos pueden pensar de que solamente subiendo nuestro código a plataformas como Github, Gitlab, Codeberg y similares es suficiente. Pero lamentablemente tienen los siguientes problemas:

  • No sirven para documentar proyectos privados.
  • La información no está ordenada y es difícil de destacar las partes importantes.
  • Dependes de un tercero y no tienes autonomía al almacenar y distribuir tu contenido.

El principal problema es que cuando participas en proyectos donde no eres dueño del código. Normalmente para empresas privadas. En tu sitio web puedes por lo menos documentar que participaste en dichos proyectos (Si tu contrato lo permite).

Además muchas veces son tantos proyectos dispersos que es mejor tener un lugar centralizado que puedes poner en tu currículum vitae.

Super Tip

Si lograste algo importante en un proyecto privado puedes crear un ejemplo que no tenga los datos restringidos y que demuestre lo que aprendiste o lograste.

De esta forma puedes tener una documentación personal y tal ves en otros proyectos futuros puedas tener este código de ejemplo o cómo lograste algo en específico.

Comienza Hoy

Lo ideal es que si eres estudiante o estas aprendiendo, comiences desde ya a tener un sitio personal que documente los proyectos, ideas, eventos y otras experiencias que has vivido en tu carrera profesional. Si ya tienes algunos años te costará un poco más comenzar a documentar todo y tomará más tiempo ordenar el material que has acumulado con el paso de los años.

¿Qué tecnología usar?

Lo más importante es tener la capacidad de migración. Si algún evento causa que tu proveedor de hosting cierre, puedas encontrar otro fácilmente y migrar tu contenido. Además de poder ser almacenado en archive.org para preservación histórica.

La recomendación es utilizar sitios web estáticos con las viejas confiables tecnologías de HTML y CSS.

Usa un generador de sitios estáticos

Lo ideal es usar uno elaborado con la tecnología que más te guste, hay diversas opciones y para todos los gustos.

Acá una selección pequeña

GitHub logo geolessel / vox

The static site builder for Elixir lovers

Vox

The static site generator for Elixir lovers.

Quick start

There is a new site generator that is the quickest way to get started In order to use it, run

mix archive.install hex vox_new
mix vox.new blog
Enter fullscreen mode Exit fullscreen mode

This will generate a simple scaffolded site that you can customize and tweak as you see fit.

There is also an example blog built with Vox that attempts to take advantage of all the features of Vox as they are built. You can look at the source code for that (and clone it and build it yourself) at geolessel/vox-example.

vox.new options

  • --esbuild - include a simple esbuild installation for asset compilation

Manual installation

The package can be installed by adding vox to your list of dependencies in mix.exs.

For now, it is recommended to install directly from GitHub. Note that the mix vox.new generator will generate the "~> 0.1.0" version instead.

Enter fullscreen mode Exit fullscreen mode

GitHub logo gohugoio / hugo

The world’s fastest framework for building websites.

Hugo

A fast and flexible static site generator built with love by bep, spf13, and friends in Go.


GoDoc Tests on Linux, MacOS and Windows Go Report Card

Website | Installation | Documentation | Support | Contributing | Mastodon

Overview

Hugo is a static site generator written in Go, optimized for speed and designed for flexibility. With its advanced templating system and fast asset pipelines, Hugo renders a complete site in seconds, often less.

Due to its flexible framework, multilingual support, and powerful taxonomy system, Hugo is widely used to create:

  • Corporate, government, nonprofit, education, news, event, and project sites
  • Documentation sites
  • Image portfolios
  • Landing pages
  • Business, professional, and personal blogs
  • Resumes and CVs

Use Hugo's embedded web server during development to instantly see changes to content, structure, behavior, and presentation. Then deploy the site to your host, or push changes to your Git provider for automated builds and deployment.

Hugo's fast asset pipelines include:

  • CSS bundling…

GitHub logo 11ty / eleventy

A simpler site generator. Transforms a directory of templates (of varying types) into HTML.

eleventy Logo

eleventy 🕚⚡️🎈🐀

A simpler static site generator. An alternative to Jekyll. Written in JavaScript. Transforms a directory of templates (of varying types) into HTML.

Works with HTML, Markdown, JavaScript, Liquid, Nunjucks, with addons for WebC, Sass, Vue, Svelte, JSX, and many others!

npm Version GitHub issues code style: prettier npm Downloads

Installation

npm install @11ty/eleventy --save-dev

Read our Getting Started guide.

Tests

npm run test

Community Roadmap

Crea tu propio generador de contenidos

Es una buena forma de practicar un lenguaje o tecnología, un proyecto pequeño que se adapte a tus necesidades. Aunque esta opción es solamente para quien desee dedicar mucho tiempo en detalles que ya están solucionados por los generadores disponibles.

Compra tu Dominio y Hosting

Lo ideal es tener un dominio y hosting propio. Puedes empezar con el hosting de Github Pages para empezar.

Proveedores de Dominio

Proveedores de Hosting

Dependiendo de tus necesidades puedes tener algo propio en una Raspberry PI, o adquirir un hosting. La siguiente es una lista no ordenada de distintas opciones.

Foto de Ilya Pavlov en Unsplash

Top comments (2)

Collapse
 
pedro_fp profile image
pedro

Otro generador de sitios estáticos
github.com/jekyll/jekyll

Collapse
 
clsource profile image
Camilo

normalmente ya disponible si tienes un github pages, es una buena opción igual aunque ya algo viejita :)