Commit f1d2dd28 authored by Alexander Martinez's avatar Alexander Martinez
Browse files

agregar documentación paltaforma LA-CoNGA

parent 3e5e69b6
# Contributing to LA-CoNGA physics
:tada::balloon::cake: **Welcome to _LA-CoNGA Physics_ repository!** :cake::balloon::tada:
🎉🎈🍰 **Welcome to _LA-CoNGA Physics_ repository!** 🍰🎈🎉
:dizzy::hatched_chick::sunny: _We're excited that you're here and want to contribute._ :sunny::hatched_chick::dizzy:
💫🐥☀️ _We're excited that you're here and want to contribute._ ☀️🐥💫
Welcome to LA-CoNGA physics repository, and thank you for thinking about contributing!
......@@ -54,7 +54,7 @@ _LA-CoNGA Physics_ activities are supported and/or developed through a set of to
Aditionally we have a set of templates availabe at [LA-CoNGA Physics templates](docs/laconga_platform.md#templates-la-conga) to support the creation of contents.
You can find more details on these tools in [LA-CoNGA Platform Guides](docs/laconga_platform.md)
You can find more details on these tools in [LA-CoNGA Platform Guides](docs/tools/laconga_platform.md)
### Other Resources
......
......@@ -17,7 +17,7 @@
**_This README.md file in also available in Spanish ([README-Spanish]())_**
-->
First and foremost, Welcome! 🎉 Te damos la bienvenida 🎊 :partying_face:!
First and foremost, Welcome! 🎉 Te damos la bienvenida 🎊 🥳!
Thank you for visiting LA-CoNGA physics Courses21B repository.
......@@ -157,13 +157,3 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
[https://laconga.redclara.net/courses/index.html](https://laconga.redclara.net/courses/index.html)
---
# LA-CoNGA Physics Platform
_LA-CoNGA Physics_ activities are supported and/or developed through a set of tools which form the _LA-CoNGA Physics_ platform. The services supported by the platform are listed below.
- [_Mattermost_ Communication Service](#mattermost-communication-service)
- [_GitLab_ Service](#gitlab-service)
- [_JupyterHUB_ Computing Service](#jupyterhub-computing-service)
- [LA-CoNGA Physics _LCMS_ service](#la-conga-physics-lcms-service)
- [LA-CoNGA Physics _website_](#la-conga-physics-website)
- [_Templates_ LA-CoNGA](#templates-la-conga)
## _Mattermost_ Communication Service
LA-CoNGA Physics internal communications are made with the [_Mattermost_]() communications service. This is a messaging service focused on communication management for workgroups. A service of this type makes it possible to organize communications in a collaborative work environment.
LA-CoNGA Physcis has two workspaces in this service which are listed below.
- [LA-CoNGA](https://mattermost.redclara.net/la-conga)for the coordination of LA-CoNGA Physics.
- [LA-CoNGA-Edu](https://mattermost.redclara.net/la-conga-edu)for the student community.
Below you will find a video tutorial for the use of this service.
<iframe width="560" height="315" src="https://www.youtube.com/embed/25Xi67bCfFY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
A more detailed guide for its use can be consulted at [Mattermost User’s Guide](https://docs.mattermost.com/guides/user.html).
## GitLab service
The Gitlab service is a [Git-based](https://git-scm.com/) collaborative software development and version control web tool. In the context of _LA-CoNGA Physics_ is one of the fundamental tools, it manages from the web service with the contents of the classes, to the tasks performed by the students. The service is available at [https://gitmilab.redclara.net/](https://gitmilab.redclara.net/) and uses the [GitLab](https://about.gitlab.com/) software.
A detailed guide to using the Gitlab service can be found at [Get started with GitLab](https://docs.gitlab.com/ee/intro/). Regarding the use of git, the book _Pro Git_ written by Scott Chacon and Ben Straub and published by Apress is an excellent guide and can be consulted for free at [https://git-scm.com/book/en/v2](https://git-scm.com/book/en/v2)
## JupyterHUB Computing Service
The JupyterHUB service is a multi-user interactive computing web service. This service offers computational capabilities from a browser to the LA-CoNGA Physics community. Through Jupyter Notebooks users can interactively, execute code in various programming languages and document the process simultaneously. Currently the service has support to programming with _Python_, _R_ and _pyRoot_.
The official documentation for the use of Jupyter Notebooks can be found at [The Jupyter Notebook Docs](https://jupyter-notebook.readthedocs.io/en/latest/notebook.html#)
## LA-CoNGA Physics LCMS service
The material for the _LA-CoNGA Physics_ module classes is created and preserved by an _LCMS-like_ service (Learning Content Management Service) called _LA_CoNGA Physics Courses_. This service uses the framework [_MkDocs_](https://www.mkdocs.org/) to build a web page. The creation and editing of the educational content for the classes is done collaboratively from the [LA-CoNGA Courses](https://gitmilab.redclara.net/tutoriales/tutorial-mkdocs) repository and hosted in the [GitLab service](gitmilab.redclara.net/). The resulting web page can be viewed in [laconga.redclara.net/courses/](laconga.redclara.net/courses/)
Below you will find a video tutorial for the use of this service.
<iframe width="560" height="315" src="https://www.youtube.com/embed/6QchBVf1YDQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
## LA-CoNGA Physics website
The official website of _LA-CoNGA Physics_ is built with the Wordpress content management system and is available on [https://laconga.redclara.net/](https://laconga.redclara.net/). On this website you will find the description of the inter-institutional alliance called _LA-CoNGA Physics_.
## Templates LA-CoNGA
Available templates for LA-CoNGA content creation:
- Presentations
+ To make presentations in *Latex*, i.e. *Beamer* you can use this [project in *Overleaf*](https://www.overleaf.com/read/gdmbcfmfwgmv). Or you can [download the *.zip* file](templates/presentations_LACoNGA_Latex.zip) to make your presentations locally.
+ Presentations in format [*.pptx* here](templates/pres_LACoNGA.pptx)
+ Presentations in format [*.odp* here](templates/pres_LACoNGA.odp).
- Text documents
+ Documents in format [*.docx*](templates/docs_LACoNGA.docx):
+ Documents in format [*.odt*](templates/docs_LACoNGA.odt):
- Reports
+ To make reports in *Latex*, i.e. *Beamer* you can use this [project in *Overleaf*](https://www.overleaf.com/project/5e3802e6d4449b000172025d). Or you can [download the *.zip* file](templates/reports_LACoNGA_Latex.zip) to make your reports locally.
......@@ -12,9 +12,9 @@ nav:
- Docentes: 'intro/docentes.md'
- Programa Académico: 'intro/programa.md'
- Calendario de Cursos 21B: 'intro/CalendarioCursos21B.md'
#- Comunidad de Estudiantes: 'Estudiantes21A.md'
- Videos de clase 21B: 'intro/videosdeClase.md'
- Herramientas:
- LA-CoNGA Platform: 'tools/laconga_platform.md'
- Descripción General: 'tools/tools.md'
- Guía Markdown: 'tools/markdown.md'
- Plantillas: "tools/plantillas/plantillas.md"
......@@ -22,6 +22,7 @@ nav:
- Astropartículas y Cosmología: 'astroparticulas-cosmologia/astroparticulas-cosmologia.md'
- Reproducibilidad Científica: 'reproducibilidad-cientifica/reproducibilidad-cientifica.md'
- Física Médica: 'fisica-medica/fisica-medica.md'
# mejorar nombre enlace
- Cursos 2021A:
- Módulo de teoría: 'https://laconga.redclara.net/courses/modulo-teoria/modulo-teoria.html'
- Módulo de instrumentación: 'https://laconga.redclara.net/courses/modulo-teoria/modulo-instrumentacion.html'
......@@ -35,13 +36,13 @@ nav:
- Docentes: 'intro/docentes.md'
- Programa Académico: 'intro/programa.md'
- Calendario de Cursos 21B: 'intro/CalendarioCursos21B.md'
#- Comunidad de Estudiantes: 'Estudiantes21A.md'
- Videos de clase 21B: 'intro/videosdeClase.md'
- Herramientas:
- Descripción General: 'tools/tools.md'
- Guía Markdown: 'tools/markdown.md'
- Plantillas: "tools/plantillas/plantillas.md"
- MkDocs: "tools/mkdocs.md"
- LA-CoNGA Platform: 'tools/laconga_platform.md'
########################################################
- Mecánica Estadística:
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment