Skip to content

Commit

Permalink
Se añaden traducciones y ajustes menores de edición
Browse files Browse the repository at this point in the history
  • Loading branch information
andoresuperesu committed Sep 25, 2024
1 parent 2d9ff16 commit 6a0a734
Show file tree
Hide file tree
Showing 4 changed files with 222 additions and 21 deletions.
171 changes: 170 additions & 1 deletion content/blog/contribuir-blog-python-barranquilla/contents+en.lr
Original file line number Diff line number Diff line change
@@ -1 +1,170 @@
_discoverable: no
_discoverable: no
---
body:


In the following article, I will talk about how to contribute to the Python Barranquilla blog. To collaborate on the community blog, you need to have prior knowledge in:
- [Lektor](#annex-1-how-to-install-lektor)
- [Git and Github](#annex-2-contribution-workflow-on-github)
- [Markdown](https://guides.github.com/features/mastering-markdown/)
- virtualenvs (this is optional).

The content of this article is divided into 2 important sections:

1. How to use the Lektor admin panel
2. How to make a Pull Request (or PR, as it's commonly known) to the PyBAQ repository.

With this clear, let's start detailing the step-by-step of each section.

## How to use the Lektor admin panel

### Clone repository

Editing the Python Barranquilla website can be done in a graphical panel. To run it, you need to clone [the project of our website](https://github.com/PyBAQ/django-quilla-web/blob/master/README.md) and install it locally using:

```bash
git clone https://github.com/PyBAQ/django-quilla-web.git
```

Once you have cloned the repository and [installed Lektor on your computer](https://www.getlektor.com/docs/installation/), you should run the local server using `lektor server -f webpack`.

![Clone repository console](/img/posts/2017/contribuir-pybaq/ejecutar.png)


### Creating an entry in Lektor

Now, go to the URL [http://localhost:5000](http://localhost:5000), and you will see the website in your browser.

![Home page](/img/posts/2017/contribuir-pybaq/home.png)

Navigate to the page you want to edit; in our case, navigate to the blog and press the edit button.

![Blog page](/img/posts/2017/contribuir-pybaq/pagina_blog.png)

Then go to the upper right corner and press a pencil-shaped button.

![Edit button](/img/posts/2017/contribuir-pybaq/boton_editar.png)

By pressing the button, the admin panel will load to edit the blog page.

![Edit blog](/img/posts/2017/contribuir-pybaq/editar_blog.png)

To proceed with creating the entry, enter the title and the [slug](https://yoast.com/slug/)

![Create entry](/img/posts/2017/contribuir-pybaq/crear_entrada.png)

Then complete the rest of the information

![Edit entry](/img/posts/2017/contribuir-pybaq/editar_entrada.png)

**Title:** Refers to the entry's title.

**Author:** The readable name of the person writing the article.

**Twitter_Handle:** Your nickname on [Twitter](http://twitter.com/).

**Publication_date:** Date in YYYY-MM-DD format with the current date.

**Excerpt:** Short summary displayed in the blog listing.

**Body:** Main content of the article.

>> _The original article had these instructions, now (2024) it is handled differently_ see [Images](#images)
>
> ### Annexes
>
> To upload images, press the **Add Attachment** button located in the sidebar.
>
> ![Upload attachments](/img/posts/2017/contribuir-pybaq/cargar_adjuntos.png)
>
> As a final step, if you upload multiple images, to only show one of the images uploaded as attachments, select the image and mark it as hidden by selecting the option *Should this page be hidden?* and disabling *If this is enabled, the page can be detected; otherwise, the URL must be known.*
> ![Hide images](/img/posts/2017/contribuir-pybaq/ocultas.png)
>
> Once the writing is finished, you can preview the article in the admin panel.
>
> ![Preview](/img/posts/2017/contribuir-pybaq/contribuir_django_quilla_web.png)
>
> You can also see it finalized in the blog.
>
> ![Final result](/img/posts/2017/contribuir-pybaq/resultado_final.png)
>

### Images
To add the main image of the article, simply attach it using the **Add Attachment** button. The program will show the image in that directory as the main image of the article.

All other images should be included in the following folder:
```
/assets/img/posts/[year]/[article-slug]/
```
You should add them as links to the img folder directly. Below is an example from this same page:
```markdown
![Clone repository console](/img/posts/2017/contribuir-blog-python-barranquilla/ejecutar.png)
```

## How to make a Pull Request to the PyBAQ repository

### Pull request

![Create Branch](/img/posts/2017/contribuir-pybaq/crear_branch.png)

To accept changes made by community members, a control of the different commits is carried out. To be able to make a commit, the person must be familiar with various Git operations such as add and commit ([see Annex 2](#annex-2-contribution-workflow-on-github)).

![Commit](/img/posts/2017/contribuir-pybaq/commit.png)

As the final step in the terminal, we push the elements to be uploaded, verifying the branch Git is currently on, as well as confirming the remote branch to which it will be uploaded.

![Push](/img/posts/2017/contribuir-pybaq/push.png)

And in the Git interface, proceed to make the final Pull Request to submit the changes for approval.

![Pull Request](/img/posts/2017/contribuir-pybaq/pull_request.png)

I hope my article was helpful. If you see that there are sections of this entry that can be improved, please leave me a comment or an [issue on Github tagging my user @Scot3004](https://github.com/PyBAQ/django-quilla-web/issues).

#### _Editor's Note:_
_For those who are just starting, we've included links to the tools you need to learn to make your contributions. Teaching and explaining to others is a great way to learn even more. Keep going!_

_Best regards, Javier_

---------------------------

## _Annex 1: How to install Lektor_
How to install it and some context.

### _What is Lektor?_
A powerful and flexible static content management system for creating complex and attractive websites from flat files—for people who don't want to compromise between a CMS and a static page generator.

### _How to install it?_
On the [Lektor website](https://www.getlektor.com/downloads/), it explains how to install it. If you have any issues, access the [community discord](https://discord.gg/46N5dPm9Zk) and ask for help.

### _How to use it?_
To understand a bit about how to use Lektor, we recommend creating your own project following the [Lektor quickstart guide](https://www.getlektor.com/docs/quickstart/). We would like to provide more help, but in this case, the documentation is already written. If English is not your thing, you can translate the page with Google.

---------------------------------

## _Annex 2: Contribution Workflow on Github_
To contribute to code projects (open or closed), we must understand the basics of Git, Github, and the importance of version control in code projects. Contributing to our blog is a way to gain that experience.

### _Understanding the workflow_
The workflow to contribute to PyBAQ is the same as almost all software projects: [pull request](https://docs.github.com/en/get-started/quickstart/github-flow). In the list below, you'll see illustrations on how to work with Github (the web platform). This interaction is usually done with Git (the tool that handles version control). Freecodecamp has a [good beginner's guide](https://www.freecodecamp.org/espanol/news/guia-para-principiantes-de-git-y-github/).

1. Pull/Fork: [Create a copy](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) of the repository in your GitHub account.
2. Branch: Create a branch with a name related to the contribution you will make.
![Branch](/img/posts/2023/contribuir-modo-facil/flow-branch.png)
3. Commit: Make changes to the code. For example: write a new article. Save the changes in that branch (branch) and commit them.
4. Push: Send the changes you have linked to the branch to your repository.
![Commit & Push](/img/posts/2023/contribuir-modo-facil/flow-commits.png)
5. Pull Request: Submit a request to include your code on the page.
![Pull Request](/img/posts/2023/contribuir-modo-facil/flow-pullreq.png)
6. Discuss: Discuss the changes you have introduced with the owners of the original repository. If there are changes, just repeat steps 3 and 4; the pull request will cover the commits you make to that branch until it is accepted.
![Discuss](/img/posts/2023/contribuir-modo-facil/flow-discuss.png)
7. Rebase + Merge: See in [original article](https://docs.github.com/en/get-started/quick

start/github-flow).
![Rebase & Merge](/img/posts/2023/contribuir-modo-facil/flow-merge.png)

If you have a basic understanding of Git but don't like the command line or don't feel comfortable with it yet, there is also [Github Desktop](https://github.com/apps/desktop).
---
title:

How to contribute to the Python Barranquilla Blog
4 changes: 0 additions & 4 deletions content/blog/contribuir-blog-python-barranquilla/contents.lr
Original file line number Diff line number Diff line change
Expand Up @@ -40,10 +40,6 @@ Una vez hayas clonado el repositorio e [instalado lektor en tu computador](https

![Clonar repositorio consola](/img/posts/2017/contribuir-pybaq/ejecutar.png)

Ahora que contamos con el repositorio, iniciamos el proyecto de manera local con Lektor:
```bash
lektor server
```

### Creación de una entrada en lektor

Expand Down
39 changes: 38 additions & 1 deletion content/blog/contribuir-modo-facil/contents+en.lr
Original file line number Diff line number Diff line change
@@ -1 +1,38 @@
_discoverable: no
_discoverable: no
---
body:

There is already an article called [How to contribute to the Python Barranquilla blog](/en/blog/contribuir-blog-python-barranquilla/). This article highlights how you can facilitate contributions using a self-configuring virtual workspace – you won't need to install anything; everything is online.

[Codespaces](https://docs.github.com/en/codespaces/overview) is a virtual workspace that can be automatically configured, provided by GitHub. A free account comes with 60 core-hours of runtime. That's more than enough time to work on contributing to our site or other projects. The Python Barranquilla page repository has a .devcontainer folder with the necessary configurations to start working immediately on any contribution you want to make.

## Edit
After creating a branch, we can open a codespace. Thanks to the .devcontainer.json file, a codespace will be created with everything you need. If your first question is, what is a branch and why is it necessary to create one? I recommend you go to [Annex 2](/blog/contribuir-blog-python-barranquilla/#anexo-2-ciclo-de-trabajo-de-contribucion-en-github) of the article mentioned at the beginning.

![Open Codespace](/img/posts/2023/contribuir-modo-facil/csflow-opencodespace.png)

The creation process may take a while the first time you open it.

![Create Codespace](/img/posts/2023/contribuir-modo-facil/csflow-createcodespace.png)

Once the editor opens, you'll see 3 parts:
1. The file browser
2. A console with the lektor server running
3. A simple browser window showing the generated page.
The page can be opened in a separate tab using the button in the top-right corner (see arrow).

![Editor Codespace](/img/posts/2023/contribuir-modo-facil/csflow-editorcodespace.png)

Finally, you can use the editor to perform both commits and pushes, but it's easiest to do this after closing the codespace window:
1. Export changes to the branch.
2. Close the codespace
It’s important to close the codespace to prevent it from consuming more runtime.

![Close Codespace](/img/posts/2023/contribuir-modo-facil/csflow-push-closecodespace.png)

## How do I create a post?
To create a blog post, follow the instructions in the article "How to contribute to the Python Barranquilla blog" starting from the title [Creating an entry in Lektor](/en/blog/contribuir-blog-python-barranquilla/#creating-an-entry-in-lektor).

If you have any questions, don't hesitate to ask in [our Discord](https://discord.gg/46N5dPm9Zk).
---
title: Contribute in Easy-Mode
29 changes: 14 additions & 15 deletions content/blog/contribuir-modo-facil/contents.lr
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
title: Contribuir en Modo Facil
title: Contribuir en Modo Fácil
---
pub_date: 2023-04-10
---
Expand All @@ -8,37 +8,36 @@ excerpt: Contribuir puede requerir aprender muchas cosas a la vez si eres princi
---
body:

Ya existe un artículo llamado [Cómo contribuir en el blog de Python Barranquilla](/blog/contribuir-blog-python-barranquilla/). En este artículo se resalta cómo se pueden facilitar las contribuciones usando un entorno de trabajo virtual que se configura solo – no tendrás que instalar nada, todo es en línea.


Ya existe un articulo llamado [Cómo contribuir en el blog de Python Barranquilla](/blog/contribuir-blog-python-barranquilla/). En este articulo se resalta como se pueden facilitar la contribución usando un entorno de trabajo virtual que se configura solo – no tendrás que instlar nada, todo es en linea.

[Codespaces](https://docs.github.com/es/codespaces/overview) es un entorno de trabajo virtual configurable de manera automática provisto por Github. Una cuenta gratis cuenta con 60 horas-nucleo de ejecución. Eso es tiempo mas que suficiente para trabajar en contribuir a nuestra pagina u otros proyectos. El repositorio de la página de Python Barranquilla de una carpeta .devcontainer con las configuraciones necesarias para empezar a trabajar de inmediato en la contribución que quieras hacer.
[Codespaces](https://docs.github.com/es/codespaces/overview) es un entorno de trabajo virtual configurable de manera automática provisto por Github. Una cuenta gratis cuenta con 60 horas-núcleo de ejecución. Eso es tiempo más que suficiente para trabajar en contribuir a nuestra página u otros proyectos. El repositorio de la página de Python Barranquilla tiene una carpeta .devcontainer con las configuraciones necesarias para empezar a trabajar de inmediato en la contribución que quieras hacer.

## Editar
Tras crear una rama, podemos abrir un codespace, gracias al archivo .devcontainer.json se creará un codespace con todo lo necesario. Si tu primera pregunta es ¿que es una rama y por que es necesario crearla? Te recomiendo ir al [Anexo 2](/blog/contribuir-blog-python-barranquilla/#anexo-2-ciclo-de-trabajo-de-contribucion-en-github) del articulo mencionado al inicio.
Tras crear una rama, podemos abrir un codespace, gracias al archivo .devcontainer.json se creará un codespace con todo lo necesario. Si tu primera pregunta es ¿qué es una rama y por qué es necesario crearla? Te recomiendo ir al [Anexo 2](/blog/contribuir-blog-python-barranquilla/#anexo-2-ciclo-de-trabajo-de-contribucion-en-github) del artículo mencionado al inicio.

![Open Codespace](/img/posts/2023/contribuir-modo-facil/csflow-opencodespace.png)
![Abrir Codespace](/img/posts/2023/contribuir-modo-facil/csflow-opencodespace.png)

El proceso de creación puede tardar un poco la primera vez que lo abres.

![Create Codespace](/img/posts/2023/contribuir-modo-facil/csflow-createcodespace.png)
![Crear Codespace](/img/posts/2023/contribuir-modo-facil/csflow-createcodespace.png)

Una vez abre el editor verás 3 partes:
1. El navegador de archivos
2. Una consola con lektor server en Ejecución
3. Una ventana de navegador simple mostrando la pagina generada.
3. Una ventana de navegador simple mostrando la página generada.
La página puede abrirse en una pestaña aparte usando el botón en la esquina superior derecha (ver flecha).

![Create Codespace](/img/posts/2023/contribuir-modo-facil/csflow-editorcodespace.png)
![Editor de Codespace](/img/posts/2023/contribuir-modo-facil/csflow-editorcodespace.png)

Por ultimo, puedes usar el editor para realizar tanto commits como push, pero lo mas facil hacerlo tras cerrar la ventana del codespace:
Por último, puedes usar el editor para realizar tanto commits como push, pero lo más fácil es hacerlo tras cerrar la ventana del codespace:
1. Exportar cambios a la rama.
2. Cerrar el codespace
Es importante cerrar el codespace para evitar que consuma mas tiempo de ejecución.
Es importante cerrar el codespace para evitar que consuma más tiempo de ejecución.

![Create Codespace](/img/posts/2023/contribuir-modo-facil/csflow-push-closecodespace.png)
![Cerrar Codespace](/img/posts/2023/contribuir-modo-facil/csflow-push-closecodespace.png)

## ¿Como creo un post?
Para poder crear un blog post, siga las instrucciones del artículo "Cómo contribuir en el blog de Python Barranquilla" a partir del título [Creación de una entrada en Lektor](/blog/contribuir-blog-python-barranquilla/#creacion-de-una-entrada-en-lektor).
## ¿Cómo creo un post?
Para poder crear un blog post, sigue las instrucciones del artículo "Cómo contribuir en el blog de Python Barranquilla" a partir del título [Creación de una entrada en Lektor](/blog/contribuir-blog-python-barranquilla/#creacion-de-una-entrada-en-lektor).

Ante las dudas, no dudes en preguntar en [nuestro discord](https://discord.gg/46N5dPm9Zk).

0 comments on commit 6a0a734

Please sign in to comment.