- Cochero, pero lejos de ser liberado?
- Sí, un par de tipografías.
Ha llegado al final: estoy escribiendo en Habr sobre cómo escribir en Habr. Aunque hay razones: he estado haciendo esto durante cinco años, he visto y probado un montón de herramientas, así que ahora estoy compartiendo lo mejor con ustedes.
Hablaré sobre cómo pasar del marcado HTML en el Editor de Habra a un diseño significativo, un diseño de publicación rápido y una colaboración productiva. Aquí, sobre mi experiencia en Yandex.Money y cómo organicé el trabajo en habratexts para que no fuera insoportablemente doloroso.
Los estilos son nuestro todo
Comenzaré con algo que no es lo más obvio para tal publicación.
Estilos: algo que inculco activamente en mis colegas y estudiantes. No se trata de infostil o científico y artístico allí, sino de cómo se ve su texto. Si algún día aprendes a hacer estilos , no habrá vuelta atrás. (Los muchachos de LaTex se rieron astutamente en este lugar; son demasiado geniales, déjenos simples mortales divertirse con el diseño).
Menú que nadie sabe usar
La conclusión es simple: puede distinguir un texto de la manera correcta, guardar la plantilla y luego aplicarla donde lo necesite. Esta plantilla se llama estilo en Word y Google Docs. Los estudiantes que escriben el diploma en estilos son 90% más felices que aquellos que cambiaron manualmente la fuente, la sangría y todo lo demás para cada párrafo y encabezado en cien páginas de texto.
Con Habr, por supuesto, todo es más simple: es suficiente para comprender la estructura de su artículo y organizar los encabezados del nivel deseado. Tratar esto es bastante simple: h1, h2, h3 y h4, como en html.
Lidiar con marcdown
Si de repente aún no lo has hecho.
Markdown es una entidad que me ha asustado desde que apareció en el editor de habra. Parecía algo hostil y, a diferencia de las etiquetas HTML habituales, se repelía por completo. La práctica ha demostrado que es mejor elegir una de las dos opciones.
Incluso si escribe en el editor Habr incorporado (aunque la administración no recomienda hacerlo), la reducción le ahorrará mucho tiempo y esfuerzo. Aunque, por supuesto, es mejor elegir otra herramienta. Habra Editor es adecuado para una vista previa correcta, y eso es todo.
Markdown es ligeramente diferente de un caso a otro. Habr tiene una rebaja con su propio gusto : el enlace es una guía comprensible, de la cual definitivamente vale la pena comenzar el camino hacia el mundo de la falta de sufrimiento con el diseño de habraposts.
Donde escribir
Escriba donde le resulte conveniente. Lo único para recordar: es conveniente escribir! = Es conveniente escribir a máquina para Habr. Si vim es conveniente para usted, continúe, y hablaré sobre formas más conservadoras de escribir textos y cómo son aplicables en Habré.
En Yandex.Money, escribimos de diferentes maneras: diferentes autores tienen diferentes editores de texto familiares, y trato de no forzarlos demasiado. Algunos autores envían documentos de texto en Yandex.Disk o por correo, otros escriben inmediatamente en el mercado o en servicios para coedición.
Código de Visual Studio (o Sublime)
Escribo este texto (y la mayoría de los otros) en VS Code, justo en el mercado. La mitad izquierda de la pantalla es para texto, y la mitad derecha es la visualización del texto creado en Markdown a través del complemento correspondiente. El complemento se llama Markdown MPE Preview: admite la descarga de imágenes desde una computadora para imgur e insertar enlaces en el lugar correcto del texto.
Post-post, meta-meta
Algunos escritores pueden culparme; dicen que Sublime Text 3 es mejor. Sé con certeza que también hay todo lo necesario para trabajar con el marqdown: úselo si lo prefiere. Bueno, en general, hay docenas, si no cientos de editores, para todas las plataformas y para todos los gustos. Lo principal es escribir bien :)
Microsoft Word
Si tiene una computadora con Windows, lo más probable es que Word esté instalado allí. Y sus coautores (si tiene coautores), muy probablemente también. Esta es una herramienta normal y familiar para la mayoría, aunque pagada.
El problema es que en Word (si no tiene una suscripción real) no puede editar documentos juntos, lo que significa que el trabajo se reducirá a Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx. Este dolor, hasta donde yo sé, persigue a algunos diseñadores, ilustradores y otros tipos "corregidos".
Pero incluso esto no es tan aterrador. El principal problema es que sin el baile ritual no verá el texto de la manera en que se verá en el sitio. Al principio parece que esto no es gran cosa. La conciencia del desastre se produce después de las primeras horas dedicadas a transferir texto desde el archivo de Word.
Honestamente, no conozco ningún convertidor público de doc a markdown, que Habr normalmente aceptará. No tengo dudas de que existen, pero los Yandex.Money habratexts en Word, si están escritos, son solo de algunos autores, y luego se convierten rápidamente en rebajas.
Google docs
Bien conocido excelente, también gratis. En la medida de lo posible, listo para el trabajo conjunto de muchos autores, editores y otros simpatizantes. La funcionalidad es suficiente para cualquier cosa. Requiere una cuenta de Google, pero ¿quién no tiene una ahora?
Es conveniente trabajar en Google Dock si varias personas escriben diferentes partes del mismo texto, por ejemplo, sobre el trabajo de las API de pago en iOS y Android. Diferentes desarrolladores, diferentes bloques, párrafos, pero todos lo ven todo, y nada se pierde en ningún lado. Una ventaja adicional es la historia de ediciones.
Aquí, como en Word, es suficiente colocar los encabezados, y luego, al exportar, no tendrá que hacer mucho trabajo innecesario.
Contras: si comparte un enlace a un archivo, es mucho más fácil que se filtre en un lugar equivocado. Pero si no escribe nada que contenga el NDA, entonces está bien. Aquí todavía todo es complicado con una vista previa de lo cargado, pero hay ventajas: transferir texto desde google-dock a un centro es mucho más fácil.
Que mas pasa
Todavía hay un mundo increíble de textos en archivos txt con sangría en tres o cinco espacios. Por razones éticas, no puedo mostrarlo (tengo miedo de abrirlo yo mismo), pero créanme: todas las opciones anteriores son definitivamente mejores.
¿De qué otra manera mejorar tu vida?
Tipógrafo
Su texto será cien veces mejor si aparecen las comillas correctas, desaparecen los guiones y los espacios dobles aleatorios. Para hacer esto, hay un tipógrafo de Lebedev studio : cargue el texto allí y en un segundo obtendrá un resultado hermoso.
Aquí se muestra una ventaja más de la rebaja: si suelta todo el Dock de Google o un archivo Word inventado en la impresora, la salida seguirá obteniendo texto sin formato. Las fotos también se perderán. Pero no hay ningún problema con la rebaja: el diseño se genera después y las imágenes son enlaces, por lo que puede hacer esto en cualquier cantidad, solo tenga tiempo de presionar Ctrl + A.
Por supuesto, esto no elimina la necesidad de verificación de texto por un buen corrector. Por otro lado, si no escribe en blogs corporativos y simplemente comparte cosas en Habré, esta es una buena ayuda en su trabajo.
Habraconvertidores
El texto de Google Docs se puede transferir de diferentes maneras, a mano o mediante diferentes convertidores. Todavía no he encontrado el ideal, así que generalmente combino la funcionalidad de dos buenos.
El primero es https://shirixae.imtqy.com/habraconverter-v2/ . Copie todo el Google Dock en el cuadro de texto, eso es todo. Genera un Markdown decente si recuerda configurar los encabezados. También es bueno que extraiga enlaces a imágenes de google-dock; por supuesto, deben volver a cargarse en Habrastorage, pero mejor que nada.
El segundo es la extensión Docs To Markdown . Genera el mejor código de descuento, funciona bien con saltos de línea, pero no conoce las imágenes.
¿Por qué es importante? Si cinco personas escriben texto con imágenes, resulta bastante difícil obtener de todos los archivos, que luego deben ser ordenados, distribuidos en el orden correcto y publicados.
Por supuesto, si escribe usted mismo y todo está cuidadosamente numerado y organizado en papás, simplemente cárguelo en Habrastorage.
Cuando edito el texto de varios autores, hago esto: tomo el texto del segundo convertidor y vuelvo a cargar las imágenes en Habrastorage utilizando los enlaces del primero. No suena súper simple, pero ahorra una cantidad infinita de tiempo.
Consejos útiles sobre rebajas y más
- Divide el texto en párrafos . Por favor!
- Fotos en Habrastorage . Esto es obvio, pero es mejor repetirlo. No hay nada peor que abrir una publicación útil hace cinco años y darse cuenta de que los enlaces a las imágenes han ido mal desde hace mucho tiempo. Por cierto, HS ofrece enlaces ya preparados envueltos en Markdown.
- En la numeración de listas, solo el primer elemento es importante; ponga el resto como desee. Esto es útil si decide reorganizar los elementos de la lista por 10 elementos, pero es demasiado vago para cambiar los números.
- Tablas - cuadros . En marqdown, tablas divertidas que rompen el cerebro por primera vez, pero Habr no sabe cómo mostrarlas bellamente: los textos en las celdas se transfieren a una nueva línea. Mejor dibujarlos en otro lugar e incrustar PNG.
upd Un buen consejo de las opanas de los comentarios es "es aconsejable colocar un spoiler cerca de la tabla de imágenes (en la que la tabla será texto y el lector podrá copiar, y el robot se encargará de la indexación)". - Se crea un nuevo dock de Google utilizando el enlace doc.new : agréguelo a la barra de marcadores para ahorrar tiempo cada vez.
- Mantenga borradores: sincronícelos con alguna nube. Por supuesto, siempre puede obtener el diseño de la publicación en Habré, pero, como muestra la práctica, es más confiable.
- La sangría entre encabezados de diferentes niveles es la cosa más aleatoria del mundo, al menos las primeras 30 veces. Asegúrese de verificar antes de la publicación que tiene una sangría normal en el texto.
- HTML mezclado con Habr-markdown puede crear errores graciosos en editores de terceros. Por ejemplo, si usa la
<code/> y olvida cerrarla correctamente. Resulta así:
Conclusiones
Todos los consejos en esta publicación están tomados de la experiencia personal. Solo ayudarán a ahorrar tiempo y nervios en el trabajo adicional que debe hacerse para preparar la publicación, y nadie canceló la redacción de un texto interesante.
La práctica muestra que si está interesado en escribir sobre algo, ni el diseño, ni html, ni la complejidad de conversión lo detendrán. Completará con éxito todas las imágenes, colocará los encabezados y las etiquetas con las manos, formateará el código y la publicación seguirá siendo buena, porque, obviamente, el texto es más importante que el diseño. Pero nadie se molesta en hacer bellas y complacer a los lectores. Entonces, necesitas hacerlo.
Entonces gana.