elhacker.net cabecera Bienvenido(a), Visitante. Por favor Ingresar o Registrarse
¿Perdiste tu email de activación?.

 

 


Tema destacado: Entrar al Canal Oficial Telegram de elhacker.net


+  Foro de elhacker.net
|-+  Foros Generales
| |-+  Foro Libre
| | |-+  Hospedar documentación html de API, ¿donde?.
0 Usuarios y 1 Visitante están viendo este tema.
Páginas: [1] Ir Abajo Respuesta Imprimir
Autor Tema: Hospedar documentación html de API, ¿donde?.  (Leído 3,217 veces)
Eleкtro
Ex-Staff
*
Desconectado Desconectado

Mensajes: 9.866



Ver Perfil
Hospedar documentación html de API, ¿donde?.
« en: 3 Enero 2016, 13:09 pm »

¿Alguien me puede orientar sobre cual sería la mejor forma de hospedar la documentación html de una API?

Me refiero a tal vez registrarse en un hosting gratuito y crear el dominio web adrede, o quizás exista algún servicio gratuito que automatize la tarea de hospedar documentación html para tal fin... lo que seria de agradecer, ya que me da mucha, muchísima pereza hacer lo primero, así que... ¿conocen alguna alternativa?.

Esta es la documentación, por favor descargar y mirar el index.html si no entienden bien mi pregunta (son solo 15 mb):
http://www.mediafire.com/download/244x2i13vtp6j1d/Web.rar
« Última modificación: 9 Enero 2016, 13:26 pm por Eleкtro » En línea



hksck

Desconectado Desconectado

Mensajes: 24


Ver Perfil
Re:
« Respuesta #1 en: 4 Enero 2016, 23:29 pm »

Sé que como opción ya te lo habrás planteado (o lo creo) y pregunto, GitHub (el cual por cierto rehuyo a más no poder por novato que soy) o sourceforge?



Enviado desde mi GT-S7580L mediante Tapatalk
En línea

#!drvy


Desconectado Desconectado

Mensajes: 5.855



Ver Perfil WWW
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #2 en: 4 Enero 2016, 23:42 pm »

Github sin duda, puedes hacerte una pagina html con su propio repositiorio usando Github Pages.
https://pages.github.com/

Saludos
En línea

.:UND3R:.
Moderador Global
***
Desconectado Desconectado

Mensajes: 3.118


Ingeniería inversa / MASM


Ver Perfil WWW
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #3 en: 4 Enero 2016, 23:52 pm »

Github sin duda, puedes hacerte una pagina html con su propio repositiorio usando Github Pages.
https://pages.github.com/

Saludos

Aclamo la noción, inclusive si no la documentación en si en su primera instancia no es tan extensa, puedes usar inclusive el mismo readme del repositorio, aquí un ejemplo:

https://github.com/echonest/pyechonest/blob/master/README.md
En línea


Solicitudes de crack, keygen, serial solo a través de mensajes privados (PM)
Eleкtro
Ex-Staff
*
Desconectado Desconectado

Mensajes: 9.866



Ver Perfil
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #4 en: 8 Enero 2016, 21:12 pm »

Gracias por las respuestas...


Pues vaya, eso me deja sorprendido, yo ya tengo una página en github pages (muy, muy cutre utilizando la plantilla por defecto) pero creia que era un servicio mucho más limitado...

de todas formas sigo sin saber como puedo hacer lo que quiero, si yo tengo todos los archivos en el disco local, y son miles de archivos... no voy a estar creando manualmente miles de páginas en el github pages, ¿como puedo montar el index.html en github pages?, ¿se puede subir el directorio con el contenido (los miles de archivos) de una sola vez?.

Saludos!
En línea



#!drvy


Desconectado Desconectado

Mensajes: 5.855



Ver Perfil WWW
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #5 en: 8 Enero 2016, 22:36 pm »

Citar
¿se puede subir el directorio con el contenido (los miles de archivos) de una sola vez?.

Si, mientras esten enlazados entre ellos no tendras ningun problema.

Saludos
En línea

Eleкtro
Ex-Staff
*
Desconectado Desconectado

Mensajes: 9.866



Ver Perfil
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #6 en: 9 Enero 2016, 13:26 pm »

Por suerte he encontrado la solución en la sección de ayuda de GitHub:

En realidad desde el propio GitHub no se puede hacer, al menos no desde el servicio que ofrecen via online.

Para construir el sitio web teniendo una estructura local de los archivos html (con el index.html y el resto de archivos que componen la página en su totalidad), hay que utilizar la consola git.exe, siguiendo al pie de la letra los pasos de esta guía:

Nota: En caso de que ya exista la página de GitHub del repositorio, para forzar la actualización y reemplazar la página hay que ignorar el comando que indica al final de la guía y utilizar este otro:
Código:
git push origin gh-pages -f

Creí que nunca lo conseguiría... ya que todos dicen que si, que era posible (no solo aquí, sino tambien en StackOverflow), pero nadie explicaba exactamente "a que botón darle" para hacerlo  y/o tampoco sabia cómo hacerlo.

¡Espero que esta información sirva para el futuro!.

Así es como me ha quedado :):

PD: Lo se, debería modificar el index.html para crear una página principal con una presentación del proyecto y enlazar la página de la documentación aparte, todo a su tiempo.

Saludos!
« Última modificación: 9 Enero 2016, 13:32 pm por Eleкtro » En línea



#!drvy


Desconectado Desconectado

Mensajes: 5.855



Ver Perfil WWW
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #7 en: 9 Enero 2016, 14:09 pm »

Eso lo tienes que hacer en todos los proyectos excepto si estas acostumbrado a usar siempre la interfaz visual.

Ahí simplemente creaste el branch gh-pages que es el que actua de servidor web  :P

Utilizar Github via su interfaz grafica me parece que es perderse parate de la esencia de lo que es GIT en si.

Saludos
En línea

Eleкtro
Ex-Staff
*
Desconectado Desconectado

Mensajes: 9.866



Ver Perfil
Re: Hospedar documentación html de API, ¿donde?.
« Respuesta #8 en: 9 Enero 2016, 15:13 pm »

Utilizar Github via su interfaz grafica me parece que es perderse parate de la esencia de lo que es GIT en si.

Si tuviese intención de dominar "la esencia" de git seguiría tu consejo (por que creo que eso fue un consejo xD), pero para el uso que le doy prefiero algo abstracto,
yo utilizo este cliente para Windows que me hace todas las tareas que necesito de una manera guiada y con el mínimo esfuerzo sin tener que documentarme sobre las bases o el funcionamiento de git en general (los branchs, pulls y demás), y también evito perder el tiempo con comandos o scripts en la interfáz command-line.


( supongo que con esa aplicación tambien se podría crear la pagína de la API... pero no tengo ni idea. )

Para gustos colores, eso está claro.

Gracias por la ayuda

Saludos!
« Última modificación: 9 Enero 2016, 15:15 pm por Eleкtro » En línea



Páginas: [1] Ir Arriba Respuesta Imprimir 

Ir a:  

Mensajes similares
Asunto Iniciado por Respuestas Vistas Último mensaje
Hospedar animaciones en imageshack.us
Diseño Gráfico
N3buR 4 2,314 Último mensaje 12 Noviembre 2006, 06:47 am
por N3buR
¿Donde puedo conseguir documentación del Modelo o Metodología SKRAM en español?
Dudas Generales
Maedhros 0 2,460 Último mensaje 7 Febrero 2012, 21:53 pm
por Maedhros
donde consigo documentacion oficial de SQL
Bases de Datos
jhonatanAsm 5 3,940 Último mensaje 29 Mayo 2012, 13:23 pm
por Saberuneko
¿dónde hospedar una galería de imágenes? « 1 2 »
Desarrollo Web
Stoya 10 5,790 Último mensaje 15 Octubre 2013, 16:19 pm
por Stoya
[Resuelto] Orientación sobre que IDE utilizar y donde hospedar mi sitio web « 1 2 »
Desarrollo Web
Eleкtro 10 10,197 Último mensaje 1 Enero 2017, 11:06 am
por Kapunk
WAP2 - Aviso Legal - Powered by SMF 1.1.21 | SMF © 2006-2008, Simple Machines