{"id":372,"date":"2014-03-29T08:30:14","date_gmt":"2014-03-29T07:30:14","guid":{"rendered":"http:\/\/descartesjs.org\/documentacion\/?p=372"},"modified":"2021-08-06T18:08:37","modified_gmt":"2021-08-06T17:08:37","slug":"embeber-escena-2","status":"publish","type":"post","link":"https:\/\/reddescartes.org\/documentacion\/embeber-escena-2\/","title":{"rendered":"Elementos generales de estilo"},"content":{"rendered":"

A continuaci\u00f3n mostramos algunos elementos generales de estilo<\/strong>, para que el aspecto de todos los art\u00edculos de la documentaci\u00f3n sea parecido.
\n<\/strong><\/p>\n

La norma general que debemos tener en cuenta es: no modificar el estilo del documento que estamos editando<\/strong>. Es decir no debemos cambiar el tipo y el tama\u00f1o de la fuente, su color, su alineaci\u00f3n, etc. De estas cuestiones se ocupa la plantilla que controla el aspecto general del portal de documentaci\u00f3n.<\/p>\n

Esto no entra en contradicci\u00f3n con que en algunos casos debamos modificar el estilo en alguno de los art\u00edculos de la documentaci\u00f3n. Pero siempre que exista alguna justificaci\u00f3n no est\u00e9tica<\/strong> para hacerlo. Por ejemplo en un art\u00edculo dedicado al uso del color puede ser necesario cambiar el color de un texto para resaltar lo que se mostar\u00e1 luego en una escena. Pero no cambiaremos el color de un t\u00edtulo por que nos parezca m\u00e1s elegante.<\/p>\n

Tras el salto introducido con el bot\u00f3n Insertar etiqueta More<\/strong> mencionaremos algunas cuestiones relativas al estilo que debemos tener en  cuenta. La primera es que, si el art\u00edculo es largo, conviene realizar una introducci\u00f3n a cada art\u00edculo, o comentar aspectos generales, y despu\u00e9s incluir un enlace Leer m\u00e1s<\/strong>. Tambi\u00e9n podemos dividir un art\u00edculo en varias p\u00e1ginas, lo que mencionaremos m\u00e1s adelante.<\/p>\n

<\/p>\n

Uso de T\u00edtulos<\/h2>\n

Los t\u00edtulos disponibles para el tama\u00f1o del texto se corresponden con las etiquetas h1<\/strong> a h6<\/strong> habituales en html. El texto principal del art\u00edculo consideramos que es su t\u00edtulo, que va en Tama\u00f1o 1<\/b>. A partir de ah\u00ed se pueden usar los siguientes tama\u00f1os, comenzando con Tama\u00f1o 2<\/strong> para t\u00edtulos de apartados<\/strong>, Tama\u00f1o 3<\/strong> para subapartados<\/strong>, etc. El cuerpo del art\u00edculo ir\u00e1 en tama\u00f1o p\u00e1rrafo<\/strong>.
\n<\/b><\/p>\n

Observa que los t\u00edtulos no acaban en punto.<\/p>\n

Formato de texto<\/h2>\n

Para resaltar texto conviene usar la opci\u00f3n negrita<\/b>. Al hacerlo se a\u00f1ade la etiqueta <strong><\/b> al texto y as\u00ed dejamos que sea la plantilla la que determine el aspecto del texto resaltado. Podemos usar cursiva para t\u00e9rminos t\u00e9cnicos (applet<\/em>), t\u00edtulos y extranjerismos, pero como norma general no conviene emplearla demasiado, pues puede ser dif\u00edcil de distinguir.<\/p>\n

Solo es conveniente aplicar un color<\/strong> a un texto cuando exista un motivo para hacerlo independiente de querer resaltarlo.<\/p>\n

Debemos tener cuidado al copiar y pegar texto que proviene de otra p\u00e1gina, pues al hacerlo puede que incluyamos elementos de estilo. Conviene realizar primero una limpieza de c\u00f3digo, por ejemplo pegar previamente el texto en un editor de texto plano y copiarlo de nuevo. Tambi\u00e9n se puede usar el bot\u00f3n Pegar como texto plano<\/strong>.<\/p>\n

Espaciado y alineaci\u00f3n<\/h2>\n

El texto estar\u00e1 siempre justificado a la izquierda<\/strong>. Esta es la opci\u00f3n por defecto de la plantilla por lo que no es necesario hacer nada en este caso. Para tablas<\/strong> el texto de la fila que la encabeza se centra autom\u00e1ticamente.<\/p>\n

No debemos generar espacios de m\u00e1s entre p\u00e1rrafos ni antes o despu\u00e9s de una imagen. De nuevo la plantilla lo hace de forma autom\u00e1tica.<\/p>\n

Paginaci\u00f3n de un art\u00edculo<\/h2>\n

Si un art\u00edculo es muy extenso conviene dividirlo en p\u00e1ginas. Para ello disponemos del bot\u00f3n Insertar salto de l\u00ednea<\/strong>. (a la derecha del que inserta el enlace Leer m\u00e1s<\/em>). Es posible insertar varios saltos de l\u00ednea en un art\u00edculo. Al final del art\u00edculo se mostrar\u00e1 un listado num\u00e9rico de las p\u00e1ginas existentes de forma autom\u00e1tica, tal y como puedes observar que ocurre en este art\u00edculo.<\/p>\n

Discusi\u00f3n de un art\u00edculo<\/h2>\n

Aunque no se trata estrictamente de un elemento de estilo, conviene mencionar este aspecto para una mejor organizaci\u00f3n de la documentaci\u00f3n. En cada art\u00edculo existe la posibilidad de realizar comentarios. Podemos usarlos para crear conversaciones relativas al contenido del art\u00edculo. Por ejemplo preguntar una duda o solicitar una ampliaci\u00f3n del art\u00edculo en cuesti\u00f3n. De esta forma se facilita seguir la evoluci\u00f3n de la documentaci\u00f3n.<\/p>\n

Uso de plugins que afectan al contenido<\/h2>\n

Siempre que incluyamos c\u00f3digo<\/strong> en un art\u00edculo como ejemplo debemos usar el plugin que facilita su lectura. Puedes encontrar informaci\u00f3n en el art\u00edculo Resaltado de c\u00f3digo<\/a>. Tambi\u00e9n es posible escribir f\u00f3rmulas en LaTeX. Consulta el art\u00edculo F\u00f3rmulas en LaTeX<\/a> para obtener mayor informaci\u00f3n.<\/p>\n","protected":false},"excerpt":{"rendered":"

A continuaci\u00f3n mostramos algunos elementos generales de estilo, para que el aspecto de todos los art\u00edculos de la documentaci\u00f3n sea parecido. La norma general que debemos tener en cuenta es: no modificar el estilo del documento que estamos editando. Es decir no debemos cambiar el tipo y el tama\u00f1o de la fuente, su color, su alineaci\u00f3n, etc. De estas cuestiones se ocupa la plantilla que controla el aspecto general del portal de documentaci\u00f3n. Esto no entra en contradicci\u00f3n con que en algunos casos debamos modificar el estilo en alguno de los art\u00edculos de la documentaci\u00f3n. Pero siempre que exista alguna<\/p>\n[Leer m\u00e1s...]<\/a>","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[8],"tags":[9],"_links":{"self":[{"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/posts\/372"}],"collection":[{"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/comments?post=372"}],"version-history":[{"count":19,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/posts\/372\/revisions"}],"predecessor-version":[{"id":3420,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/posts\/372\/revisions\/3420"}],"wp:attachment":[{"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/media?parent=372"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/categories?post=372"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/reddescartes.org\/documentacion\/wp-json\/wp\/v2\/tags?post=372"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}