texto-nivel-semantico.rst 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442
  1. .. 4.5
  2. ==========================
  3. Semántica a nivel de texto
  4. ==========================
  5. El elemento ``a``
  6. =================
  7. Define un `hipervínculo <https://www.w3.org/TR/html51/links.html#hyperlink>`__.
  8. .. code-block:: html
  9. <nav>
  10. <ul>
  11. <li><a href="/">Home</a> </li>
  12. <li><a href="/news">News</a> </li>
  13. <li><a>Examples</a> </li>
  14. <li><a href="/legal">Legal</a> </li>
  15. </ul>
  16. </nav>
  17. Puede usarse con los siguientes atributos:
  18. - ``href``. La dirección del hipervínculo.
  19. - ``target``. El contexto de navegación.
  20. - ``download``. Indica si se debe descargar el recurso en vez de dirigirse a este.
  21. - ``rel``. Relación del documento actual con el recurso de destino.
  22. - ``rev``. Relación del recurso de destino con el documento actual.
  23. - ``hreflang``. El idioma del recurso enlazado.
  24. - ``type``. El tipo MIME del recurso enlazado.
  25. Los atributos ``target``, ``download``, ``rel``, ``rev``, ``hreflang`` y ``type``
  26. deben omitirse si el atributo ``href`` no está presente.
  27. El elemento ``em``
  28. ==================
  29. El elemento ``<em>`` representa el énfasis en el contenido como un acento de
  30. intensidad.
  31. .. code-block:: html
  32. <p>Los <em>gatos</em> son animales preciosos.</p>
  33. El elemento ``strong``
  34. ======================
  35. Es el apropiado para marcar con especial énfasis las
  36. partes más importantes de un texto.
  37. Puede usarse en un encabezado, un título o un párrafo para
  38. distinguir la parte que realmente importa de otras partes que podrían ser más
  39. detalladas o simplemente publicadas.
  40. .. code-block:: html
  41. <h1>Capítulo 1: <strong>La Práctica</strong></h1>
  42. El elemento ``small``
  43. =====================
  44. Aplica el tamaño mínimo de la fuente de texto del navegador, este elemento se
  45. utiliza para representar comentarios secundarios y letras pequeñas, incluidos
  46. los derechos de autor y el texto legal, independientemente de su presentación con estilo.
  47. .. code-block:: html
  48. <body>
  49. <dl>
  50. <dt>Habitacion simple
  51. <dd>199 € <small>Desayuno incluido, IVA no incluido</small>
  52. <dt>Habitacion doble
  53. <dd>239 € <small>Desayuno incluido, IVA no incluido</small>
  54. </dl>
  55. </body>
  56. El elemento ``s``
  57. =================
  58. El elemento ``<s>`` representa los contenidos que ya no son precisos o que ya no son relevantes.
  59. .. code-block:: html
  60. <body>
  61. <p>Compra nuestro refresco</p>
  62. <p><s>Precio recomendado: $3.99 por botella</s></p>
  63. <p><strong>Ahora lo vendemos a : $2.99 una botella!</strong></p>
  64. </body>
  65. El elemento ``cite``
  66. ====================
  67. El elemento ``<cite>`` representa una referencia a un trabajo creativo o científico.
  68. Debe incluir el título de la obra o el nombre del autor
  69. (persona, personas u organización) o una referencia URL, o una referencia en
  70. forma abreviada según las convenciones utilizadas para la agregación de metadatos
  71. de citas.
  72. .. code-block:: html
  73. <body>
  74. <p>En palabras de <cite>Charles Bukowski</cite> -
  75. <q>Un intelectual dice una cosa simple de una manera dura.
  76. <br>Un artista dice una cosa difícil de una manera sencilla.</q></p>
  77. </body>
  78. El elemento ``q``
  79. =================
  80. El elemento ``<q>`` crea citas en línea, marca las citas de otros autores o documentos.
  81. .. code-block:: html
  82. <!DOCTYPE html>
  83. <html>
  84. <head>
  85. <title></title>
  86. </head>
  87. <body>
  88. <p>El estándar dice: <q cite='https://www.w3.org/TR/html51/textlevel-semantics.html#elementdef-q'>
  89. ... O sirve para citas cortas (contenido en línea) que no necesitan cambios de párrafo.</q>
  90. </p>
  91. </body>
  92. </html>
  93. El elemento ``dfn``
  94. ===================
  95. El elemento ``<dfn>`` sirve para marcar el término que se quiere definir.
  96. .. code-block:: html
  97. <body>
  98. <p>El <dfn>HTML</dfn> es un lenguaje de marcado para hipertextos.</p>
  99. </body>
  100. El elemento ``abbr``
  101. ====================
  102. Representa una abreviación o un acrónimo, opcionalmente proporciona una
  103. explicación de su significado. Si está presente, el atributo ``title`` debe
  104. contener simplemente su significado.
  105. .. code-block:: html
  106. <body>
  107. <p>Escribo <abbr title="Hypertext Markup Language">HTML</abbr></p>
  108. </body>
  109. El elemento ``data``
  110. ====================
  111. Usamos el elemento ``<data>`` para representa un contenido, junto con el
  112. atributo ``value`` crea un formato legible de ese contenido para una computadora.
  113. El atributo ``value`` debe estar presente. Su valor debe ser una representación
  114. del contenido del elemento en un formato entendible por la computadora.
  115. El formato de los datos para que una computadora pueda leerlos son RDF, XML, JSON.
  116. .. code-block:: html
  117. <body>
  118. <p>Nuevos Productos</p>
  119. <ul>
  120. <li><data value="3967381398">Mini Ketchup</data></li>
  121. <li><data value="3967381399">Jumbo Ketchup</data></li>
  122. <li><data value="3967381400">Mega Jumbo Ketchup</data></li>
  123. </ul>
  124. </body>
  125. El elemento ``time``
  126. ====================
  127. Representa el valor de una fecha y hora. El formato equivalente
  128. legible por una computadora se debe indicar en el atributo ``datetime``
  129. .. code-block:: html
  130. <body>
  131. <time>2011-11-18 06:54:39.929-08:00</time>
  132. </body>
  133. El atributo ``datetime`` debe reflejar el contenido de la fecha
  134. y hora del elemento añadido.
  135. .. code-block:: html
  136. <body>
  137. <div class="vevent">
  138. <a class="url" href="https://www.example.com/">https://www.w2conf.com/</a>
  139. <span class="resumen">Web 2.0 Conferencia</span>:
  140. <time class="dtstart" datetime="2005-10-05">Octubre 5</time> -
  141. <time class="dtend" datetime="2005-10-07">7</time>,
  142. at the <span class="location">Gran Hotel, Almeria</span>
  143. </div>
  144. </body>
  145. El elemento ``code``
  146. ====================
  147. Representa un código de ordenador.
  148. Es un fragmento de código de un programa de computadora o cualquier otra cadena
  149. que una computadora podría reconocer.
  150. .. code-block:: html
  151. <body>
  152. <p>El <code>code</code>es un elemento que representa un fragmento de código.</p>
  153. <p>Cuando llama al método <code> activate() </code> en el objeto
  154. <code> robot </code>, los ojos le brillan. </p>
  155. <p> El ejemplo siguiente utiliza la palabra clave <code> begin </code> para indicar
  156. el inicio de un bloque de instrucciones. Se empareja con una palabra <code> end </code>
  157. , seguida por el <code>. </code> carácter de puntuación
  158. (punto final) para indicar el final del programa. </p>
  159. </body>
  160. El atributo ``class`` se utiliza en este ejemplo para indicar el lenguaje programacion utilizado.
  161. .. code-block:: html
  162. <body>
  163. <pre><code class="language-pascal">var i: Integer;
  164. begin
  165. i := 1;
  166. end.</code></pre>
  167. </body>
  168. El elemento ``var``
  169. ===================
  170. Representa una variable, es decir, una expresión matemática o contexto de
  171. programación, un identificador que represente a una constante, un símbolo que
  172. identifica una cantidad física, un parámetro de una función o un marcador de
  173. posición en prosa.
  174. .. code-block:: html
  175. <body>
  176. <figure>
  177. <math>
  178. <mi>a</mi>
  179. <mo>=</mo>
  180. <msqrt>
  181. <msup><mi>b</mi><mn>2</mn></msup>
  182. <mi>+</mi>
  183. <msup><mi>c</mi><mn>2</mn></msup>
  184. </msqrt>
  185. </math>
  186. <figcaption>
  187. Utilizando el teorema de Pitágoras para resolver la hipotenusa <var>a</var>
  188. de un triángulo con lados <var>b</var> and <var>c</var>
  189. </figcaption>
  190. </figure>
  191. </body>
  192. El elemento ``samp``
  193. ====================
  194. Representa la muestra o la salida cotizada de otro programa o sistema informático.
  195. .. code-block:: html
  196. <p> La computadora dijo</p>
  197. <p>aparecerá una ventana con el mensaje: <samp>Hola mundo</samp>
  198. </p>
  199. El elemento ``kbd``
  200. ===================
  201. La utilidad del elemento ``<kbd>`` es la entrada de datos por parte del usuario (normalmente la entrada
  202. del teclado, aunque también se puede utilizar para representar otras entradas,
  203. como los comandos de voz).
  204. .. code-block:: html
  205. <p>Hacer que Jorge coma una manzana, pulsar <kbd><kbd>Shift</kbd>+<kbd>F3</kbd></kbd></p>
  206. .. code-block:: html
  207. <p>Hacer que Jorge coma una manzana, seleccionar
  208. <kbd><kbd><samp>Archivo</samp></kbd>|<kbd><samp>Comer manzana...</samp></kbd></kbd>
  209. </p>
  210. El elemento ``sub``
  211. ===================
  212. Crea un subíndice posicionando el texto marcado por debajo de la línea.
  213. .. code-block:: html
  214. <p>Las mujeres más guapas son
  215. <span lang="fr"><abbr>M<sup>lle</sup></abbr> Gwendoline</span> y
  216. <span lang="fr"><abbr>M<sup>me</sup></abbr> Denise</span>.</p>
  217. El elemento ``i``
  218. =================
  219. Representa una extensión de texto en una voz o estado de ánimo alternativo,
  220. un término técnico, una frase idiomática de otro idioma, una transliteración,
  221. un pensamiento, o el nombre de una nave en textos occidentales.
  222. .. code-block:: html
  223. <p>El <i class="taxonomy">Felis silvestris catus</i> es bonito.</p>
  224. <p>El término<i>contenido en prosa</i> esta definido encima.</p>
  225. <p>Estas en lo cierto <i lang="fr">je ne sais quoi</i> esta en el aire.</p>
  226. El elemento ``b``
  227. =================
  228. Representa una extensión de texto a la que se está llamando la atención con
  229. fines utilitarios sin transmitir ninguna importancia extra y sin implicación de
  230. una voz o estado de ánimo alternativo, como palabras clave en un documento
  231. abstracto, nombres de productos en una revisión, En software interactivo basado
  232. en texto, o en un artículo.
  233. .. code-block:: html
  234. <body>
  235. <p>El <b>hidrógeno</b> y el <b>carbono</b> son componentes básicos de la materia.</p>
  236. </body>
  237. El elemento ``u``
  238. =================
  239. Representa una extensión de texto con una anotación no textual, aunque
  240. explícitamente traducida, no textual, como etiquetar el texto como un nombre
  241. propio en un texto chino (una marca china), o etiquetar el texto como mal escrito.
  242. .. code-block:: html
  243. <body>
  244. <p><u>Todo</u> se explica
  245. <u>buceando dentro de Python</u></p>
  246. <p><em>Todo</em> se explica
  247. <i>buceando dentro de Python</i></p>
  248. </body>
  249. El elemento ``mark``
  250. ====================
  251. Representa un texto resaltado, es decir, una ejecución de texto marcado para referencia,
  252. debido a su relevancia en un contexto particular. Por ejemplo, se puede utilizar
  253. en una página que muestra los resultados de búsqueda para resaltar cada uno de estos por palabra.
  254. .. code-block:: html
  255. <p lang="en-US">Consider the following quote:</p>
  256. <blockquote lang="en-GB">
  257. <p>Look around and you will find, no-one’s really
  258. <mark>colour</mark> blind.</p>
  259. </blockquote>
  260. <p lang="en-US">As we can tell from the <em>spelling</em> of the word,
  261. the person writing this quote is clearly not American.</p>
  262. El elemento ``bdi``
  263. ===================
  264. Aisla un trozo de texto para que pueda ser formateado con una dirección diferente
  265. al texto que hay fuera de él.
  266. Es útil al embeber o incrustar texto del que se desconoce la direccionalidad,
  267. por ejemplo, proveniente de una base de datos, dentro de un texto con una
  268. direccionalidad fija.
  269. .. code-block:: html
  270. <p dir="ltr">Esta palabra arábica<bdi>ARABIC_PLACEHOLDER</bdi>
  271. se muestra automáticamente de derecha a izquierda.
  272. </p>
  273. El elemento ``bdo``
  274. ===================
  275. La dirección de escritura del texto está relacionada con el idioma y se declara
  276. con el atributo ``dir``. Pero en ocasiones esto no es suficiente, entonces entra en
  277. juego el elemento ``bdo`` (anulación del algoritmo bidireccional) que al anular el
  278. algoritmo permite un control total de la direccionalidad del contenido.
  279. .. code-block:: html
  280. <p> cero(0)
  281. <bdo dir="rtl">
  282. <em> uno(1) dos(2) </em> tres(3) cuatro(4)
  283. <em dir="ltr"> cinco(5) seis(6) </em> siete(7) ocho(8)
  284. </bdo> nueve(9)
  285. </p>
  286. El elemento ``span``
  287. ====================
  288. Es un contenedor en línea. Sirve para aplicar estilo al texto o agrupar elementos
  289. en línea.
  290. .. code-block:: html
  291. <div style="border: 1px dotted blue;">
  292. <h4>Ejemplo de div y span </h4>
  293. <p>Esto es un párrafo dentro de un div,
  294. <span style="color: red;"> y esto un span dentro de un párrafo. </span>
  295. </p>
  296. </div>
  297. El elemento ``br``
  298. ==================
  299. Usar ``<br>`` produce un salto de línea en el texto
  300. **(retorno de carro)**. Es útil para escribir un poema o una dirección, donde la
  301. división de las líneas es significante.
  302. No utilices ``<br>`` para incrementar el espacio entre líneas de texto; para ello
  303. utiliza la propiedad ``margin`` de CSS o el elemento ``<p>``.
  304. .. code-block:: html
  305. <p>P. Sherman<br>
  306. 42 Wallaby Way<br>
  307. Sydney</p>
  308. El elemento ``wbr``
  309. ===================
  310. El uso de ``<wbr>`` (*word break opportunity*) te permite dividir la palabra,
  311. haciendo un salto de línea si la palabra no entra en el navegador, evitando así
  312. el scroll horizontal. Es útil en el caso de que una palabra sea muy larga y no
  313. entre en la misma línea. A diferencia de la etiqueta ``<br>`` solo hace salto de línea
  314. cuando la palabra no entra horizontalmente en el navegador o choca con el marco de la
  315. ventana del navegador.
  316. .. code-block:: html
  317. <p>Entonces señaló al tigre y gritó
  318. "Es<wbr>el<wbr>mayor<wbr>tigre<wbr>que<wbr>he<wbr>visto<wbr>en<wbr>mi<wbr>vida<wbr>. ¡Corre, si nos coge, estamos perdidos!".</p>