- Coachman, mas longe de ser libertado?
- Sim, algumas composições.
Chegou ao fim - estou escrevendo em Habr sobre como escrever em Habr. Embora existam razões - eu venho fazendo isso há cinco anos, já vi e experimentei várias ferramentas, então agora estou compartilhando o melhor com você.
Falarei sobre como passar da marcação HTML no Editor Habra para um layout significativo, um design rápido de postagem e uma colaboração produtiva. Aqui - sobre minha experiência no Yandex.Money e como organizei o trabalho em habratexts para que não fosse dolorosamente doloroso.
Os estilos são tudo
Começarei com algo que não é o mais óbvio para essa postagem.
Estilos - algo que eu instilo ativamente em meus colegas e alunos. Não se trata de infostil ou científico e artístico, mas sobre a aparência do seu texto. Se você um dia aprender a criar estilos , não haverá como voltar atrás. (Os caras do LaTex riram maliciosamente deste lugar - você é muito legal, deixe-nos mortais simples se divertir com o design.)
Menu que ninguém sabe usar
A linha inferior é simples - você cria um pedaço de texto da maneira correta, salva o modelo e o aplica sempre que precisar. Esse modelo é chamado de estilo no Word e no Google Docs. Os alunos que digitam o diploma em estilos são 90% mais felizes do que aqueles que alteraram manualmente a fonte, o recuo e tudo o mais para cada parágrafo e o cabeçalho em cem páginas de texto.
Com o Habr, é claro, tudo é mais simples - basta entender a estrutura do seu artigo e organizar os títulos do nível desejado. Lidar com isso é bastante simples - h1, h2, h3 e h4 - como no html.
Lidar com marcdown
Se de repente você não tem.
Markdown é uma entidade que me assustou desde que apareceu no editor de habra. Parecia algo hostil e diferente das tags HTML usuais e completamente repelido. A prática mostrou que é melhor escolher uma das duas opções.
Mesmo se você escrever no editor Habr interno (embora a administração não recomende isso), a redução de preço economizará muito tempo e esforço. Embora, é claro, seja melhor escolher outra ferramenta. O Editor Habra é adequado para uma visualização correta, e é tudo.
A remarcação é um pouco diferente de caso para caso. Habr tem uma remarcação com seu próprio gosto - o link é um guia compreensível, do qual definitivamente vale a pena começar o caminho para o mundo da falta de sofrimento com o layout dos habraposts.
Onde escrever?
Escreva onde for conveniente para você. A única coisa a lembrar: é conveniente escrever! = É conveniente digitar para Habr. Se o vim for conveniente para você, vá em frente, e falarei sobre maneiras mais conservadoras de escrever textos e como elas são aplicáveis em Habré.
No Yandex.Money, escrevemos de maneiras diferentes - autores diferentes têm editores de texto familiares diferentes e tento não forçá-los demais. Alguns autores enviam documentos de texto no Yandex.Disk ou por correio, outros escrevem imediatamente no mercado ou em serviços para co-edição.
Código do Visual Studio (ou Sublime)
Eu escrevo este texto (e a maioria dos outros) no VS Code, bem no mercado. A metade esquerda da tela é para texto e a metade direita é a exibição do texto composto no Markdown por meio do plug-in correspondente. O plugin se chama Markdown MPE Preview - ele suporta o download de imagens de um computador para imgur e a inserção de links no lugar certo no texto.
Pós-pós, meta-meta
Alguns escritores podem me culpar - eles dizem que o Sublime Text 3 é melhor. Sei com certeza que também há tudo para trabalhar com o marqdown - use-o se preferir. Bem, em geral, existem dezenas, senão centenas de editores, para todas as plataformas e para todos os gostos. O principal é escrever bem :)
Microsoft Word
Se você possui um computador Windows, provavelmente o Word está instalado lá. E seus co-autores (se você tiver co-autores), provavelmente também. Essa é uma ferramenta normal e familiar para a maioria, embora paga.
O problema é que, no Word (se você não possui uma assinatura real), não é possível editar documentos juntos, o que significa que o trabalho será reduzido para Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx. Essa dor, tanto quanto eu sei, assombra alguns designers, ilustradores e outros caras "corrigidos".
Mas mesmo isso não é tão assustador. O principal problema é que, sem a dança ritual, você não verá o texto como ele ficará no site. A princípio, parece que isso não é grande coisa. A conscientização do desastre ocorre após as primeiras horas gastas na transferência de texto do arquivo do Word.
Honestamente, não conheço nenhum conversor público de doc para markdown, o que o Habr normalmente aceita. Não tenho dúvida de que eles existem, mas os Yandex.Money habratexts no Word, se forem escritos, são apenas de alguns autores, e rapidamente se transformam em descontos.
Documentos do Google
Coisa excelente bem conhecida, também grátis. Tanto quanto possível, pronto para o trabalho conjunto de muitos autores, editores e outros simpatizantes. Funcionalidade é suficiente para qualquer coisa. Requer uma conta do Google, mas quem não tem uma agora?
É conveniente trabalhar no Google Dock se várias pessoas escreverem partes diferentes do mesmo texto - por exemplo, sobre o trabalho de APIs de pagamento no iOS e no Android. Diferentes desenvolvedores, diferentes blocos, parágrafos, mas todo mundo vê tudo, e nada se perde em lugar nenhum. Uma vantagem separada é o histórico das edições.
Aqui, como no Word, basta colocar os cabeçalhos e, ao exportar, você não precisará fazer muito trabalho desnecessário.
Contras - se você compartilhar um link para um arquivo, será muito mais fácil vazar em algum lugar no lugar errado. Mas se você não escrever nada contendo o NDA, tudo bem. Tudo ainda é complicado aqui com uma prévia do upload, mas há vantagens - transferir texto do google-dock para um hub é muito mais fácil.
O que mais acontece
Ainda existe um mundo incrível de textos em arquivos txt com recuo em três a cinco espaços. Por razões éticas, não posso mostrar (tenho medo de abri-lo), mas acredite: todas as opções acima são definitivamente melhores.
De que outra forma melhorar sua vida
Tipógrafo
Seu texto será cem vezes melhor se as aspas corretas estiverem presentes, hífens e espaços duplos aleatórios desaparecerem. Para fazer isso, existe um tipógrafo de estúdio Lebedev - faça o upload do texto para lá e, em um segundo, você obterá um resultado bonito.
Aqui, mais uma parte da remarcação é mostrada aqui - se você soltar o Google Dock inteiro ou um arquivo Word inventado na impressora, a saída ainda terá texto sem formatação. As imagens também serão perdidas. Mas não há problema com a remarcação - o layout é gerado depois e as imagens são links, para que você possa fazer isso em qualquer quantidade, basta ter tempo para pressionar Ctrl + A.
Obviamente, isso não nega a necessidade de verificar o texto com um bom corretor. Por outro lado, se você não escreve em blogs corporativos e apenas compartilha coisas no Habré, essa é uma boa ajuda no seu trabalho.
Habraconverters
O texto do Google Docs pode ser transferido de diferentes maneiras - manualmente ou através de diferentes conversores. Ainda não encontrei o ideal, por isso costumo combinar a funcionalidade de duas boas.
O primeiro é https://shirixae.imtqy.com/habraconverter-v2/ . Copie o Google Dock inteiro na caixa de texto - é isso. Ele gera um Markdown decente se você se lembrar de definir os cabeçalhos. Também é bom que ele retire links para fotos do google-dock - eles, é claro, precisam ser recarregados no Habrastorage, mas melhor do que nada.
O segundo é a extensão Docs To Markdown . Gera o melhor código de remarcação, funciona bem com quebras de linha, mas não conhece imagens.
Por que é importante - se cinco pessoas escrevem texto com imagens, é bastante difícil obter todos os arquivos, que precisam ser classificados, dispostos na ordem correta e publicados.
Claro, se você escreve a si mesmo e tudo é cuidadosamente numerado e organizado nos pais, basta fazer o upload para Habrastorage.
Quando edito o texto de vários autores, faço isso - pego o texto do segundo conversor e reenvio as fotos para Habrastorage usando os links do primeiro. Não parece super simples, mas economiza uma quantidade infinita de tempo.
Dicas úteis sobre descontos e muito mais
- Divida o texto em parágrafos . Por favor!
- Fotos em Habrastorage . Isso é óbvio, mas é melhor repetir. Não há nada pior do que abrir um post útil cinco anos atrás e perceber que os links para as fotos há muito tempo não funcionam. A propósito, o HS fornece links prontos envoltos no Markdown.
- Na numeração de listas, apenas o primeiro elemento é importante; coloque o restante como quiser. Isso é útil se você decidir reorganizar os elementos da lista por 10 elementos, mas com preguiça de alterar os números.
- Tabelas - fotos . Em marqdown, mesas engraçadas que quebram o cérebro pela primeira vez várias vezes, mas Habr não sabe como exibi-las lindamente - os textos nas células são transferidos para uma nova linha. Melhor desenhá-los em outro lugar e incorporar PNG.
upd. Uma boa dica dos opanas a partir dos comentários é "é aconselhável colocar um spoiler próximo à tabela de figuras (na qual a tabela será texto e o leitor poderá copiar, e o robô lidará com a indexação)". - Um novo dock do Google é criado usando o link doc.new - adicione-o à barra de favoritos para economizar tempo a cada vez.
- Mantenha os rascunhos - sincronize-os com algumas nuvens. Obviamente, você sempre pode obter o layout da publicação em Habré, mas, como mostra a prática, é mais confiável.
- O recuo entre títulos de diferentes níveis é a coisa mais aleatória do mundo, pelo menos pelas primeiras 30 vezes. Certifique-se de verificar novamente, antes da publicação, se você tem um recuo normal no texto.
- HTML misturado com a marcação Habr pode criar bugs engraçados em editores de terceiros. Por exemplo, se você usar a
<code/> e esquecer de fechá-la corretamente. Acontece assim:
Conclusões
Todas as dicas deste post foram tiradas da experiência pessoal. Eles apenas ajudarão a economizar tempo e nervosismo no trabalho adicional que precisa ser feito na preparação do post - e ninguém cancelou a redação de um texto interessante.
A prática mostra que, se você estiver interessado em escrever sobre algo, nem o layout, nem o html, nem a complexidade da conversão o impedirão. Você preencherá com sucesso todas as imagens, posicionará os cabeçalhos e as tags com as mãos, formatará o código e a postagem continuará boa - porque, obviamente, o texto é mais importante que o design. Mas ninguém se incomoda em deixar os leitores bonitos e agradáveis. Então, você precisa fazer isso.
Então vença.