Si estás haciendo el tutorial en casa

Si estás haciendo el tutorial en casa, y no en uno de los eventos de Django Girls, puedes saltar este capítulo por completo e ir directamente al capítulo ¿cómo funciona Internet?.

Esto es porque cubrimos estas cosas en todo el tutorial de todos modos, y esto es sólo una página adicional que recoge todas las instrucciones de instalación en un solo lugar. El evento de Django Grils incluye una "noche de la instalación" en la que instalamos todo, así que no tenemos que molestar con ella durante el taller, así que esto es útil para nosotros.

Si lo encuentras útil, puedes seguir este capítulo también. Pero si quieres empezar a aprender antes de instalar un montón de cosas en tu computadora, sáltate este capítulo y te explicaremos la parte de instalación más adelante.

¡Buena suerte!

Instalación

En el taller construiremos un blog, y hay algunas tareas de configuración en el tutorial que sería bueno hacer de antemano para que estés listo para comenzar a codificar en el día.

Chromebook setup (if you're using one)
Puedes [saltarte esta sección](http://tutorial.djangogirls.org/en/installation/#install-python) en caso de que no estés usando un Chromebook. Si lo estás usando, tu experiencia de instalación será algo diferente. Puedes ignorar el resto de las instrucciones de instalación. ### IDE en la nube (PaizaCloud Cloud IDE, AWS Cloud9) Un IDE en la nube es una herramienta que te da un editor de código y acceso a un ordenador conectado a internet en el que puedes instalar, escribir y ejecutar software. En este tutorial, el IDE en la nube te servirá como tu *máquina local*. Seguirás ejecutando comandos en una terminal igual que tus compañeros de clase en OS X, Ubuntu, o Windows, pero tu terminal en realidad estará conectada a un ordenador corriendo en otro sitio que el IDE en la nube gestionará para ti. Aquí están las instrucciones para IDEs en la nube (PaizaCloud Cloud IDE, AWS Cloud9). Puedes elegir uno de los IDEs en la nube, y seguir sus instrucciones. #### PaizaCloud Cloud IDE 1. Ve a [PaizaCloud Cloud IDE](https://paiza.cloud/) 2. Crea una cuenta 3. Haz click en *New Server* 4. Haz click en el botón Terminal (en el lado izquierdo de la ventana) Ahora deberías ver una interfaz con una barra y botones en la izquierda. Haz click en al botón "Terminal" para abrir la ventana de la terminal con un símbolo de sistema como este:

Terminal

$ La terminal enviará tus instrucciones al ordenador que Cloud 9 ha preparado para ti. Puedes redimensionar o maximizar la ventana para hacerla un poco mas grande. #### AWS Cloud9 1. Ve a [AWS Cloud9](https://aws.amazon.com/cloud9/) 2. Crea una cuenta 3. Haz click en *Create Environment* Deberías ver un interfaz con una barra lateral, una ventana principal grande con texto y una ventana pequeña abajo del todo parecida a esto:

bash

yourusername:~/workspace $ La parte inferior es tu *terminal*, donde escribirás las instrucciones para el ordenador que Cloud 9 te ha preparado. Puedes redimensionar la ventana para hacerla un poco más grande. ### Entorno Virtual Un entorno virtual (también llamado virtualenv) es como una caja privada donde podemos guardar código útil para el proyecto en el que estamos trabajando. Lo usamos para guardar por separado los trozos de código de distintos proyectos, y que así, las cosas no se mezclen entre proyectos. En la terminal de la parte inferior de Cloud 9, ejecuta lo siguiente:

Cloud 9

sudo apt update sudo apt install python3.6-venv Si aun así, no te funciona, pide ayuda a tu mentor. A continuación, ejecuta:

Cloud 9

mkdir djangogirls cd djangogirls python3.6 -mvenv myvenv source myvenv/bin/activate pip install django~=2.0.6 (fíjate que en la última línea hemos usado una tilde seguida de un signo de igual: ~=). ### GitHub Hazte una cuenta de [GitHub](https://github.com). ### Python Anywhere El tutorial de Django Girls tiene una sección que se llama "Despliegue", que es el proceso de coger el código de tu nueva aplicación web y ponerlo en un ordenador públicamente accesible (un servidor) para que todo el mundo pueda ver tu trabajo. Esta parte "chirría" un poco cuando haces el tutorial en un Chromebook, porque que ya estamos usando un ordenador que ya está en Internet (en lugar de un ordenador local como un portátil). Sin embargo, aún tiene sentido, si pensamos que nuestro espacio de trabajo en Cloud9 es un lugar para nuestro trabajo "en progreso" y PythonAnywhere es el lugar donde enseñar nuestro sitio web más terminado. Así que créate una cuenta de PythonAnywhere en [www.pythonanywhere.com](https://www.pythonanywhere.com).

Instalar Python

Para lectores en casa: este capitulo se cubre en el video Installing Python & Code Editor.

Esta sección está basada en un tutorial de Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)

Django esta escrito en Python. Necesitamos Python para hacer cualquier cosa en Django. Comencemos instalandolo!. Tenemos que instalar Python 3.6, así que si tienes una versión anterior, debes actualizarla.

Install Python: Windows

Primero comprueba si tu computador tiene una version de Windows de 32-bit o 64-bit, presiona tecla Windows + Pause/Break, esto abrirá tu System info (información de tu sistema), ahora busta la linea "System type". Puedes descargar Python para Windows desde el sitio web https://www.python.org/downloads/windows/. Haz click en el link "Latest Python 3 release - Python x.x.x.". Si tu computador tiene una versión de Windows de 64 bits, descarga Windows x86-64 executable installer. De lo contrario, descarga Windows x86 executable installer. Después de descargar el instalador, debes ejecutarlo (hazle doble click) y sigue las instrucciones.

Algo a tener en cuenta: Durante la instalación notarás una ventana llamada "Setup". Asegúrate de seleccionar la casilla "Add Python 3.6 to Path" y luego haz click en "Install Now", como se muestra a continuación:

No te olvides de agregar Python al Path

En los próximos pasos, vas a utilizar la línea de comandos de Windows (acerca de la cual también de contaremos algo). De momento, si tienes que teclear algunos comandos, ve al menú de Inicio y teclea "Command Prompt" en el cuadro de búsqueda. (En versiones anteriores de Windows, puedes arrancar la linea de comandos con menú de Inicio → Sistema Windows → Linea de Comandos.) También puedes pulsar la tecla "Windows" + R hasta que aparezca la ventana "Ejecutar" (Run). Para abrir la línea de comandos, escribe "cmd" y pulsa enter en la ventana "Run".

Escribe "cmd" en la ventana "Run&quot

Nota: Si estas utilizando una versión anterior de Windows (7, Vista, o cualquier versión anterior) y el instalador de Python 3.6.x falla con un error, puedes tratar ya sea:

  1. instalar todas las actualizaciones de Windows e intentar instalar Python 3.6 nuevamente; o
  2. instalar una versión de Python anterior, por ejemplo, 3.4.6.

Si instalas una versión anterior de Python, la pantalla de instalación puede ser un poco diferente a la que se muestra arriba. Asegúrate de desplazarte hacia abajo para ver "Add python.exe to Path", y dar click en el botón a la izquierda y seleccionar "Will be installed on local hard drive":

Añadir Python a Path, versiones más antiguas

Install Python: OS X

Nota Antes de instalar Python en OS X, debes asegurarte de que la configuración del Mac permita instalar paquetes que no estén en la App Store. ve a preferencias del sistema (System Preferences, está en la carpeta Aplicaciones), da click en "Seguridad y privacidad" (Security & Privacy) y luego la pestaña "General". Si tu "Permitir aplicaciones descargadas desde:" (Allow apps downloaded from:) está establecida a "Mac App Store," cambia a "Mac App Store y desarrolladores identificados." (Mac App Store and identified developers)

Debes ir al sitio web https://www.python.org/downloads/release/python-361/ y descargar el instalador de Python:

  • Descargar el archivo Mac OS X 64-bit/32-bit installer,
  • Haz doble clic en python-3.4.3-macosx10.6.pkg para ejecutar al instalador.
Install Python: Linux

Es muy posible que ya tengas Python instalado de serie. Para verificar que ya lo tienes instalado (y qué versión es), abre una consola y escribe el siguiente comando:

command-line

$ python3 --version
Python 3.6.1

Si tienes una 'micro versión' diferente de Python instalada, por ejemplo 3.6.0, entonces no tienes que actualizar. Si no tienes instalado Python o si deseas una versión diferente, puedes instalarla de la siguiente manera:

Install Python: Debian or Ubuntu

Escribe este comando en tu consola:

command-line

sudo yum install python3.6
Install Python: Fedora

Usa este comando en tu consola:

command-line

$ sudo dnf instalar python3

En versiones anteriores de Fedora tal vez te salga un error de que no se encuentra el comando dnf. En ese caso utiliza yum en su lugar.

Install Python: openSUSE

Usa este comando en tu consola:

command-line

$ sudo zypper install python3

Verifica que la instalación fue exitosa abriendo una terminal y ejecutando el comando python3:

command-line

$ python3 --version
Python 3.6.1

NOTA: Si estás en Windows y recibes un mensaje de error no se encontró python3, intenta usar python (sin el 3) y comprueba si todavía es una versión de Python 3.6.


Si tienes alguna duda o si algo salió mal y no sabes cómo resolverlo - ¡pide ayuda a tu tutor! A veces las cosas no van bien y que es mejor pedir ayuda a alguien con más experiencia.

Instala un Editor de Código

Hay muchos editores diferentes y la elección es principalmente una cuestión de preferencia personal. La mayoría de programadores de Python usan IDEs (Entornos de Desarrollo Integrados) complejos pero muy potentes, como PyCharm. Sin embargo, como principiante, probablemente no es lo más aconsejable; nuestras recomendaciones son igualmente potentes pero mucho más simples.

Abajo presentamos nuestras sugerencias pero, también puedes preguntarle a tu mentor cuáles son las suyas - será más fácil que te ayude.

Gedit

Gedit es un editor de texto de código abierto, gratuito, y que está disponible para todos los sistemas operativos.

Descárgalo aquí

Sublime Text 3

Sublime Text es un editor muy popular con un período de prueba gratis. Es fácil de instalar y de usar, y está disponible para todos los sistemas operativos.

Descárgalo aquí

Atom

Atom es otro editor que usa mucha gente. Es gratuito, de código abierto y hay versiones para Windows, OS X y Linux. Atom ha sido desarrollado por GitHub.

Descárgalo aquí

¿Por qué estamos instalando un editor de texto?

Tal vez te estés preguntando por qué estamos instalando un editor especializado en código, en lugar de usar un editor convencional como Word o Notepad.

La principal razón es que el código tiene que ser texto plano y, el problema con programas como Word y Textedit es que no guardan texto plano, sino que guardan texto enriquecido (con estilos), usando formatos personalizados como RTF(Rich Text Format).

La segunda razón es que los editores de texto son herramientas especiales para editar código, porque tienen características útiles como resaltar el código con diferentes colores de acuerdo a su significado, o cerrar comillas automáticamente.

Veremos todo esto en acción más adelante. Pronto el editor de código se convertirá en una de tus herramientas favoritas. :)

Crea un entorno virtual (virtualenv) e instala Django

Parte de esta sección se basa en tutoriales por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Parte de este capítulo está basada en el django-marcador tutorial bajo la licencia Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.

Entorno virtual

Antes de instalar Django, instalaremos una herramienta extremadamente útil que ayudará a mantener tu entorno de desarrollo ordenado en tu computadora. Es posible saltarse este paso, pero es altamente recomendable. ¡Empezar con la mejor configuración posible te ahorrará muchos problemas en el futuro!

Así que, vamos a crear un entorno virtual (también llamado un virtualenv). Virtualenv aísla tu configuración de Python/Django por cada proyecto. Esto quiere decir que cualquier cambio que hagas en un sitio web no afectará a ningún otro que estés desarrollando. Genial, ¿no?

Todo lo que necesitas hacer es encontrar un directorio en el que quieras crear el virtualenv; tu directorio home, por ejemplo. En Windows, puede verse como C:\Users\Name (donde Name es el nombre de tu usuario).

NOTA: En Windows, asegúrate de que este directorio no contiene caracteres especiales o acentuados; si tu nombre de usuario contiene caracteres acentuados, usa un directorio distinto, por ejemplo C:\djangogirls.

Para este tutorial usaremos un nuevo directorio djangogirls en tu directorio home:

command-line

$ mkdir djangogirls
$ cd djangogirls

Haremos un virtualenv llamado myvenv. El comando general estará en el formato:

command-line

$ python3 -m venv myvenv
Virtual environment: Windows

Para crear un nuevo virtualenv, necesitas abrir una terminal "command prompt" y ejecutar python -m venv myvenv. Se verá así:

command-line

C:\Users\Name\djangogirls> python -m venv myvenv

Donde myvenv es el nombre de tu virtualenv. Puedes utilizar cualquier otro nombre, pero asegúrate de usar minúsculas y no usar espacios, acentos o caracteres especiales. También es una buena idea mantener el nombre corto. ¡Vas utilizarlo muchas vecesl!

Virtual environment: Linux and OS X

Podemos crear un virtualenv en Linux y OS X, es tan sencillo como ejecutar python3 -m venv myvenv. Se verá así:

command-line

$ python3 -m venv myvenv

myvenv es el nombre de tu virtualenv. Puedes usar cualquier otro nombre, pero sólo utiliza minúsculas y no incluyas espacios. También es una buena idea mantener el nombre corto. ¡Vas a referirte muchas veces a él!

NOTA: En algunas versiones de Debian/Ubuntu, puede que obtengas el siguiente error:

command-line

The virtual environment was not created successfully because ensurepip is not available.  En sistemas Debian/Ubuntu, tendrás que instalar el paquete python3-venv usando el siguiente comando.
   apt-get install python3-venv
Puede que tengas que usar sudo con este comando.  Después de instalar el paquete python3-venv, vuelve a crear tu entorno virtual.

En este caso, sigue las instrucciones anteriores e instala el paquete python3-venv:

command-line

$ sudo apt install python3-venv

NOTA: En algunas versiones de Debian/Ubuntu inicializar el entorno virtual de esta manera da el siguiente error:

command-line

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

Para evitar esto, utiliza directamente el comando virtualenv.

command-line

$ sudo apt-get install python-virtualenv
$ virtualenv --python=python3.6 myvenv

NOTA: Si obtienes un error como

command-line

E: Unable to locate package python3-venv

entonces ejecuta:

command-line

sudo apt install python3.6-venv

Trabajar con virtualenv

El comando anterior creará un directorio llamado myvenv (o cualquier nombre que hayas elegido) que contiene nuestro entorno virtual (básicamente un montón de archivos y carpetas).

Working with virtualenv: Windows

Inicia el entorno virtual ejecutando:

command-line

C:\Users\Name\djangogirls> myvenv\Scripts\activate

Nota: en 10 de Windows puedes obtener un error en Windows PowerShell que dice execution of scripts is disabled on this system. En este caso, abre otro Windows PowerShell con la opción "Ejecutar como administrador". Luego intenta escribir el siguiente comando antes de inicializar tu entorno virtual:

command-line

C:\WINDOWS\system32 > Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
   Execution Policy Change
   The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
Working with virtualenv: Linux and OS X

Inicia el entorno virtual ejecutando:

command-line

$ source myvenv/bin/activate

¡Recuerda reemplazar myvenv con tu nombre de virtualenv que hayas elegido!

NOTA: a veces source podría no estar disponible. En ese caso trata hacerlo de esta forma:

command-line

$ . myvenv/bin/activate

Sabrás que tienes virtualenv iniciado cuando veas que la línea de comando en tu consola tiene el prefijo (myvenv).

Cuando trabajes en un entorno virtual, python automáticamente se referirá a la versión correcta, de modo que puedes utilizar python en vez de python3.

Ok, tenemos todas las dependencias importantes en su lugar. ¡Finalmente podemos instalar Django!

Instalar Django

Ahora que tienes tu virtualenv iniciado, puedes instalar Django.

Antes de hacer eso, debemos asegurarnos que tenemos la última versión de pip, el software que utilizamos para instalar Django:

command-line

(myvenv) ~$ python3 -m pip install --upgrade pip

Instalar paquetes con un fichero de requisitos (requirements)

Un fichero de requisitos (requirements) tiene una lista de dependencias que se deben instalar mediante pip install:

Lo primero, crea un fichero requirements.txt dentro del directorio djangogirls/, usando el editor de código que hemos instalado hace un momento:

djangogirls
└───requirements.txt

Dentro del fichero djangogirls/requirements.txt deberías tener el siguiente texto:

djangogirls/requirements.txt

Django~=2.0.6

Ahora, ejecuta pip install -r requirements.txt para instalar Django.

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=2.0.6 (from -r requirements.txt (line 1))
  Downloading Django-2.0.6-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-2.0.6
Installing Django: Windows

Si obtienes un error al ejecutar pip en Windows comprueba si la ruta de tu proyecto contiene espacios, acentos o caracteres especiales (por ejemplo, C:\Users\User Name\djangogirls). Si los tiene, por favor considera moverla a otro lugar sin espacios, acentos o caracteres especiales (sugerencia: C:\djangogirls). Crea un nuevo virtualenv en el nuevo directorio, luego borra el viejo y reintenta el comando anterior. (Mover el directorio de virtualenv no funciona puesto que virtualenv usa rutas absolutas.)

Installing Django: Windows 8 and Windows 10

Puede que tu línea de comandos se congele después de que intentes instalar Django. Si esto sucede, en vez del comando anterior utiliza:

command-line

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
Installing Django: Linux

Si obtienes un error al ejecutar pip en Ubuntu 12.04 ejecuta python -m pip install -U --force-reinstall pip para arreglar la instalación de pip en el virtualenv.

¡Eso es todo! Ahora estás lista (por fin) para crear una aplicación Django!

Instalar Git

Git es un "sistema de control de versiones" que utilizan muchos programadores. Este software puede seguir los cambios realizados en archivos a lo largo del tiempo de forma que más tarde puedas volver a cualquier versión anterior. Es un poco parecido a la opción de "control de cambios" de Microsoft Word, pero mucho más potente.

Instalar Git

Installing Git: Windows

Puedes descargar Git desde git-scm.com. Puedes hacer click en "next" en todos los pasos a excepción de uno; en el quinto paso titulado "Adjusting your PATH environment", escoge "Use Git and optional Unix tools from the Windows Command Prompt" (la de abajo del todo). Aparte de eso, los valores por defecto están bien. "Checkout Windows-style, commit Unix-style line endings" también está bien.

No olvides reiniciar la terminal o powershell después de que la instalación termine.

Installing Git: OS X

Descarga Git de git-scm.com y sigue las instrucciones.

Nota Si estas usando OS X 10.6, 10.7 o 10.8, tendrás que instalar git desde aquí: Git installer for OS X Snow Leopard

Installing Git: Debian or Ubuntu

command-line

$ sudo apt install git
Installing Git: Fedora

command-line

$ sudo dnf install git
Installing Git: openSUSE

command-line

$sudo zypper install git

Crear una cuenta de GitHub

Visita GitHub.com y registra una nueva cuenta de usuario gratuita.

Crear una cuenta de PythonAnywhere

PythonAnywhere es un servicio para ejecutar código Python en servidores "en la nube". Lo vamos a usar para alojar nuestro sitio para que esté disponible en Internet.

Crea una cuenta de Principiante ("Beginner") en PythonAnywhere (el nivel gratuito está bien, no necesitas tarjeta de crédito).

La página de inicio de PythonAnywhere con un botón para crear una cuenta de principiante ("Beginner") gratuita

Nota Cuando elijas un nombre de usuario, recuerda que la URL de tu blog tendrá la forma tunombredeusuario.pythonanywhere.com, así que lo mejor será usar tu apodo o elegir un nombre que indique de qué trata tu blog.

Crear un token para la API de PythonAnywhere

Solo tendrás que hacer esto la primera vez. Cuando entres en PythonAnywhere, verás el panel de control ("dashboard"). En la esquina superior derecha, busca el enlace la página de tu cuenta ("Account"), selecciona una pestaña llamada "API token" y pulsa el botón que pone "Create new API token".

La pestaña de "API token" en la página de tu cuenta ("Account")

Comienza a leer

Felicitaciones, ya tienes todo configurado y listo para seguir! Si aún tienes tiempo antes del taller, sería útil comenzar a leer algunos de los capítulos iniciales:

¡Disfrutar el taller!

Al comenzar el taller, podrás ir directamente a Tu primer proyecto en Django! porque ya cubriste el material de los capítulos anteriores.

results matching ""

    No results matching ""