Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gonzalo2310/sdras-helper
The main idea is to create a simple and intuitive help system.
https://github.com/gonzalo2310/sdras-helper
helper helper-creator
Last synced: 16 days ago
JSON representation
The main idea is to create a simple and intuitive help system.
- Host: GitHub
- URL: https://github.com/gonzalo2310/sdras-helper
- Owner: Gonzalo2310
- License: mit
- Created: 2018-03-06T00:55:39.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-27T15:35:23.000Z (about 6 years ago)
- Last Synced: 2024-11-01T11:42:37.728Z (2 months ago)
- Topics: helper, helper-creator
- Language: Vue
- Size: 757 KB
- Stars: 27
- Watchers: 6
- Forks: 4
- Open Issues: 17
-
Metadata Files:
- Readme: README-es.md
- Changelog: history-es.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT-es.md
Awesome Lists containing this project
README
# SDras Helper
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/1725baabb7114607bbd116f394f06e00)](https://www.codacy.com/app/godan2310/SDras-Helper?utm_source=github.com&utm_medium=referral&utm_content=Gonzalo2310/SDras-Helper&utm_campaign=Badge_Grade)#### Status: Alpha version
> Basado en la idea de Sarah Drasner (@sdras). Un ejemplo de la creación de Sarah Drasner a la que se hace referencia: [JavaScript Array Explorer](https://codepen.io/sdras/full/gogVRX/). Mas información en history-es.md
## Version de nodejs
> Para que la api de servicios de archivos funcione se debe usar como mínimo node 8.11.1 ya que se utiliza la función fs.copyFile y fue introducida en la versión 8.5.
## Idea
La idea principal es poder crear un sistema de ayuda sencillo e intuitivo. El sistema da las herramientas para seguir el formato creado por Sarah Drasner en sus ejemplos.
## Iniciar el sistema
Dos terminales deben ser abiertos para poder operar el sistema:
Terminal 1:
``` bash
# entrar al servidor interno de archivos
cd src
cd internalServer# instalar dependencias
npm install# inicia el servidor de archivos en http://localhost:5000
npm start
```
Terminal 2:
``` bash
# instalar dependecias
npm install# servidor con reload automatico si cambia el codigo en localhost:8000
npm run dev
```## Como usar el producto
Si se han seguido las instrucciones, la segunda terminal lanza el servicio en http://localhost:8000/#/
El sistema cuenta con dos projectos de los que luego se hablara aquí. Para comenzar a crear se debe ir a la siguiente url: http://localhost:8000/#/admin
Comienza un menu de 7 opciones:
#### List of projects:
Aqui se crean los nuevos proyectos, se eliminan, renombran o seleccionan.
El nombre de cada proyecto debe ser una palabra única
#### Profile
Hagamos una comparacion grafica del producto original para entender los campos
![profile example](images/profile.png)
El vinculo a github aun no ha sido desarrollado
#### Idiomas
Contiene los idiomas extras para el proyecto ademas de ingles. Solo se crean las carpetas y las relaciones de contenidos correspondientes pero no hay traduccion automática.
En principio todos los contenidos son en ingles y deben ser traducidos manualmente.
Mas informacion de idiomas en language-es.md
#### Antes de continuar
El sistema se divide en 3 elementos.
**Step**: titulo y descripcion. Puede tener descendencia
**Finish**: Contiene información variada y no puede contener hijos. Es la respuesta definitiva luego de varios Steps.
**Structure**: Establece en forma de arbol las relaciones de contenido#### Continuando con el menu Steps:
Cada step tiene 3 campos:
* Name: Debe ser unico e irrepetible. No se debe traducir. No lo ve el usuario
Los otros dos se explican de forma gráfica:
![Steps](images/steps.png)
Cada steps puede contener tantos steps o finish como necesite. No hay limite de recursividad.
Lo logico es que al final se llegue a un finish.
#### finish
Finish tiene varios campos.
* Name: Unico, Irrepetible. No se puede traducir. No lo ve el usuario
Los otros los veremos de forma gráfica
![finish](images/finish.png)
Los finish no pueden tener descendencia.
#### Structure
Es donde se establece el orden de presentacion de los steps y finish creados. Se usa un formato de arbol para ello.
#### Create project
Este es el ultimo paso para crear el proyecto. Sobre los productos creados y sus dependencias leer: ProyectDependencies-es.md
Una vez el proyecto ha sido creado, usted puede acceder http://localhost:8000/#/ y acceder a una lista de projectos creados para usar.
Para extraer el producto creado hacia otro proyecto lea: Extractfinalproduct-es.md
#### Desarrollo
Si desea conocer mas sobre el codigo o los procesos internos del sistema lea: Developers-es.md
#### Example y Default
El sistema ofrece un ejemplo basado en la creacion de Sarah Drasner ya terminado y disponible para la modificacion a en `Admin` o como uso de pruebas en `/`.
`Default` por el contrario, es la base de las creaciones. Cualquier cambio en el valor predeterminado será heredado por proyectos posteriores.
#### Colaboradores
* ![Juan Manuel Cruz](https://avatars0.githubusercontent.com/u/4992593?s=60&v=4) [Juan Manuel Cruz (Malows)](https://github.com/Malows)
* ![Daniel Primo](https://avatars1.githubusercontent.com/u/1122071?s=60&v=4) [Daniel Primo (delineas)](https://github.com/delineas)
* ![PabloJS](https://avatars1.githubusercontent.com/u/25794960?s=60&v=4) [PabloJS](https://github.com/PabloJS)
* ![Alexandre Ballesté](https://avatars0.githubusercontent.com/u/1745437?s=60&v=4) [Alexandre Ballesté (sinmsinm)](https://github.com/sinmsinm)
* ![Laura Santana](https://avatars2.githubusercontent.com/u/11777927?s=60&v=4) [Laura Santana (LalyStana)](https://github.com/LalyStana)#### Creado por
![Gonzalo Nandez](https://avatars0.githubusercontent.com/u/6000947?s=60&v=4) [Gonzalo Nandez (Gonzalo2310)](https://github.com/Gonzalo2310)#### Inspirado en una idea de:
![Sarah Drasner](https://avatars2.githubusercontent.com/u/2281088?s=60&v=4) [Sarah Drasner (sdras)](https://github.com/sdras)