Por favor no hagas un fork de este repositorio desde GitHub, directamente. Utiliza el importador de GitHub siguiendo las instrucciones para copiar el repositorio
workshop-template-esy, así, editarlo de acuerdo a las necesidades de tu taller.
Trabaja en el branch
gh-pagesde tu repositorio, ya que este es el contenido que será publicado automáticamente como un sitio web por GitHub.
Una vez que hayas terminado, por favor avísanos [por medio de un email] cual será la URL de tu taller. Si se trata de un taller auto-organizado, también debes [completar el formulario para talleres autoorganizados][self-organised-workshop-form], para que podamos seguir el desarrollo de todos los talleres. En nuestro sitio web, construimos una lista de talleres a partir de los datos que incluyas en tu página
index.md. Sólo podemos hacer eso si editas tu página correctamente y nos informas sobre la URL del taller.
Si tienes problemas o ideas sobre cómo hacer este proceso de una forma más simple, por favor ponte en contacto. Las páginas para personalizar tu sitio web, las FAQ, y las notas de diseño tienen más detalles sobre lo que hacemos y por qué. Y ten en cuenta: si estás enseñando sobre Git, por favor [crea un repositorio aparte](# setting-up-a-separate-repository-for-learners) para que los estudiantes puedan practicar.
Creating a Repository
Log in to GitHub. (If you do not have an account, you can quickly create one for free.) You must be logged in for the remaining steps to work.
Go to GitHub's importer.
Paste the url of this repo as the old repository to clone: https://github.com/carpentries-es/workshop-template-es.
Select the owner for your new repository. (This will probably be you, but may instead be an organization you belong to.)
Choose a name for your workshop website repository. This name should have the form
YYYY-MM-DDis the start date of the workshop.
Make sure the repository is public.
At this point, you should have a page like this:
You can now click "Begin Import". When the process is done, you will receive a message like "Importing complete! Your new repository gvwilson/2016-12-01-miskatonic is ready." and you can go to the new repository by clicking on the name.
Note: some people have had intermittent errors during the import process, possibly because of the network timing out. If you experience a problem, please re-try; if the problem persists, please get in touch.
Customizing Your Website
Go into your newly-created repository, which will be at
https://github.com/your_username/YYYY-MM-DD-site. For example, if your username is
gvwilson, the repository's URL will be
Ensure you are on the gh-pages branch by clicking on the branch under the drop down in the menu bar (see the note below):
Edit the header of
index.mdto customize the list of instructors, workshop venue, etc. You can do this in the browser by clicking on it in the file view on GitHub and then selecting the pencil icon in the menu bar:
Editing hints are embedded in
index.md, and full instructions are in the customization instructions.
_config.ymlto customize certain site-wide variables, such as:
carpentry(to tell us which carpentry workshop this is),
title(overall title for all pages),
repository(so that URLs resolve correctly both locally and on GitHub),
workshop_repo(the URL of the workshop repository on GitHub) and
workshop_site(the repository's GitHub Pages URL).
Editing hints are embedded in
_config.yml, and full instructions are in the customization instructions.
schedule.htmlfile to edit the schedule for your upcoming workshop. This file is located in the
_includesdirectory, make sure to choose the one from the appropriate
dc(Data Carpentry workshop),
lc(Library Carpentry), or
sc(Software Carpentry) subdirectory.
Alternatively, if you are already familiar with Git, you can clone the repository to your desktop, edit
schedule.htmlthere, and push your changes back to the repository.
git clone -b gh-pages https://github.com/your_username/YYYY-MM-DD-site
You should specify
-b gh-pagesto checkout the gh-pages branch because the imported repository doesn't have a
In order to view your changes once you are done editing, you must push to your GitHub repository:
git push origin gh-pages
When you are done editing, go to the GitHub Pages URL for your workshop and preview your changes. In the example above, this is
https://gvwilson.github.io/2016-12-01-miskatonic. The finished page should look something like this.
Optional: you can now change the README.md file in your website's repository, which contains these instructions, so that it contains a short description of your workshop and a link to the workshop website.
please do all of your work in your repository's
since GitHub automatically publishes that as a website.
Note: this template includes some files and directories that most workshops do not need, but which provide a standard place to put extra content if desired. See the design notes for more information about these.
Further instructions are available in the customization instructions. This FAQ includes a few extra tips (additions are always welcome) and these notes on the background and design of this template may help as well.
Checking Your Changes
If you want to preview your changes on your own machine before publishing them on GitHub, you can do so as described below.
Install the software described below. This may require some work, so feel free to preview by pushing to the website.
Run the command
and go to http://0.0.0.0:4000 to preview your site. You can also run this command by typing
make serve(assuming you have Make installed).
Run the command
to check for a few common errors in your workshop's home page. (You must have Python 3 installed to do this.)
(Optional) Linking to Your Page
At the top of your repository on GitHub you'll see
No description or website provided. — Edit
Click 'Edit' and add:
A very brief description of your workshop in the "Description" box (e.g., "Miskatonic University workshop, Dec. 2016")
The URL for your workshop in the "Website" box (e.g.,
This will help people find your website if they come to your repository's home page.
Creating Extra Pages
In rare cases,
you may want to add extra pages to your workshop website.
You can do this by putting either Markdown or HTML pages in the website's root directory
and styling them according to the instructions give in
the lesson template.
If you do this,
you must also edit
_config.yml to set these three values:
carpentryis either "dc" (for Data Carpentry), "swc" (for Software Carpentry), or "lc" (for Library Carpentry). This determines which logos are loaded.
titleis the title of your workshop (typically the venue and date).
but there is no way to avoid this
without requiring people to edit both files in the usual case
where no extra pages are created.
If you want to set up Jekyll so that you can preview changes on your own machine before pushing them to GitHub, you must install the software described below. (Note: Julian Thilo has written instructions for installing Jekyll on Windows.)
Ruby. This is included with Linux and macOS; the simplest option on Windows is to use RubyInstaller. You can test your installation by running
ruby --version. For more information, see the Ruby installation guidelines.
RubyGems (the package manager for Ruby). You can test your installation by running
Jekyll. You can install this by running
gem install jekyll.
Setting Up a Separate Repository for Learners
If you are teaching Git, you should create a separate repository for learners to use in that lesson. You should not have them use the workshop website repository because:
your workshop website repository contains many files that most learners don't need to see during the lesson, and
you probably don't want to accidentally merge a damaging pull request from a novice Git user into your workshop's website while you are using it to teach.
You can call this repository whatever you like, and add whatever content you need to it.