Foros del Web » Creando para Internet » HTML »

Documentación HTML

Estas en el tema de Documentación HTML en el foro de HTML en Foros del Web. Hola tengo 2 preguntas, ojala me puedan ayudar... Acabo de crear un sitio web con HTML, CSS, Javascript, pero necesito documentar dicho sitio tanto con ...
  #1 (permalink)  
Antiguo 26/11/2011, 12:27
 
Fecha de Ingreso: noviembre-2011
Mensajes: 3
Antigüedad: 12 años, 5 meses
Puntos: 0
Pregunta Documentación HTML

Hola tengo 2 preguntas, ojala me puedan ayudar...
Acabo de crear un sitio web con HTML, CSS, Javascript, pero necesito documentar dicho sitio tanto con comentarios en el código, como en un documento de texto.
En java puedo poner comentarios javadoc y con una herramienta se autogenera un API.... Alguien sabe si existe alguna herramienta similar para HTML, CSS y Javascript??

La otra es: existen estandares para el código web y donde los puedo encontrar? como cuantos caracteres por línea máximo puedo poner, o como identar los tags o si los tags van con mayusculas o minusculas, etc...

ayuda por favor...
  #2 (permalink)  
Antiguo 26/11/2011, 12:45
Avatar de zerokilled
Javascripter
 
Fecha de Ingreso: abril-2009
Ubicación: Isla del Encanto, La Borinqueña [+>==]
Mensajes: 8.050
Antigüedad: 15 años
Puntos: 1485
Respuesta: Documentación HTML

buenas,
veamos por parte. me suena muy raro el tipo de documentación que deseas hacer para html y css, pues estos no son lenguajes de programación. para javascript existen varias herramientas pero no te puedo recomendar alguno porque nunca los he utilizado. de todos modos, en wikipedia puedes ver una lista de generadores y los lenguajes que soporta.

si, existen estándares web y la mayoría de las documentaciones oficiales las puedes encontrar en w3.org. no hay restrincción de caracteres por líneas ni una norma definitiva de como debe identarse los tags. sin embargo, se recomienda adoptar la práctica de la legibilidad ya que este ayudará agilizar la producción en equipo o para uno mismo. pero esto también depende del tipo de herramientas que utilices. porque si utilizas un editor web, me temo que podrás controlar como el código se genera. sobre las mayúsculas y minúsculas, depende del tipo de documento. por ejemplo, html no distingue entre los dos, pero xml y sus aplicaciones derivadas (xhtml, rss, svg) son sensibles a las mayúsculas y minúsculas.

__________________
la maldad es una virtud humana,
y la espiritualidad es la lucha del hombre contra su maldad.

Etiquetas: css
Atención: Estás leyendo un tema que no tiene actividad desde hace más de 6 MESES, te recomendamos abrir un Nuevo tema en lugar de responder al actual.
Respuesta




La zona horaria es GMT -6. Ahora son las 10:59.