maxpress

MaxPress: MarkDown + Python realiza layout de contas públicas do WeChat com um clique

---

Tutorial para iniciantes atualizado para pessoas não técnicas:

[Parte 1: Princípios Básicos] "Boas notícias para pessoas preguiçosas: como ser um editor do WeChat que nunca faz composição tipográfica?" 》

[Próximo artigo: Guia de gramática] "Guia completo para composição tipográfica MarkDown para contas oficiais do WeChat"

---

Funções básicas

1. Converta em lote documentos MarkDown em arquivos HTML adequados para colar no editor WeChat.
2. Suporta personalização: tamanho do texto, cor do texto (cor do texto, cor do tema, cor de referência), espaçamento entre linhas, espaçamento entre parágrafos, alinhamento horizontal do título, proporção de espaço em branco em ambos os lados do conteúdo e imagem inferior.
3. O documento MarkDown convertido pode ser movido e arquivado automaticamente.

Comece

download

Baixe a versão estável mais recente: versão Windows/versão Mac

Usando a versão Windows/Mac do programa executável

Composição tipográfica com um clique

1. Use Markdown para criar seu conteúdo, salve-o como um arquivo .md e coloque-o no diretório temp .
2. Clique duas vezes para executar o programa maxpress e um arquivo .html com o mesmo nome será gerado no diretório result／html .
3. Abra o arquivo .html gerado com um navegador, selecione tudo, copie e cole no editor WeChat.
4. Verifique, visualize, ajuste.

【Notas】

1. Certifique-se de enviá-lo para o seu celular para visualização antes de enviá-lo. O autor não garante que o estilo final esteja absolutamente correto.
2. Certifique-se de manter uma cópia do documento original fora do diretório do software antes da conversão. O autor não é responsável pela perda acidental de dados.
3. Atualmente, testamos o navegador Chrome apenas no Win/Mac. Se a formatação for perdida/desfigurada durante esta etapa, forneça comentários sobre o problema e explique os problemas que você encontrou, o sistema e o navegador que você usou.
4. Suporta conversão em lote de vários arquivos .md e vários subdiretórios (incluindo subdiretórios aninhados).
5. O arquivamento automático é realizado por padrão, ou seja, todos os arquivos .md originais serão movidos para o diretório de result／archive após a conversão. Esta função pode ser desabilitada modificando o arquivo de configuração (auto_archive).
6. Se ocorrer um conflito de nome de arquivo, o nome de arquivo padrão será automaticamente substituído. Você pode modificar o arquivo de configuração (auto_rename) para executar a renomeação automática.

Ajuste de formato

Antes de executar o programa de conversão, modifique o arquivo config.json para customizar variáveis ​​de formato comuns.

incluem:

nome da variável	valor padrão	ilustrar
tamanho_principal	16 pixels	Tamanho do texto principal
tema_cor	#349971	Cor do tema, usada para cores de texto, como títulos, elementos de ênfase, etc.
cor_texto	#555	Cor do texto do corpo
quote_color	#999	Cor do texto na caixa de referência e na caixa de código
altura_linha	2h	Altura da linha de texto
para_espaçamento	1,5em	Espaçamento entre parágrafos de texto
alinhar	Múltiplo	Recomenda-se que o alinhamento horizontal de cada parte left ou center ( h1 ~ h6 representa o título 1 ~ título 6, content representa o texto principal)
margem_principal	3%	A proporção de espaço em branco em ambos os lados do conteúdo
banner_url	""	O URL da imagem no cabeçalho do artigo que direciona a atenção
poster_url	""	O código/endereço QR da imagem do pôster na parte inferior
lista_de_conversão	verdadeiro	Converta a lista no texto em um parágrafo comum para corrigir o problema de que o WeChat não consegue exibir o estilo do número de sequência da lista corretamente (apenas para WeChat)
estilo_ul	"○"	Identificação do símbolo antes de cada item após a conversão de uma lista não ordenada em um parágrafo normal (habilitado somente quando convert_list for true )
arquivo_automático	""	Se deseja arquivar automaticamente (mover o arquivo .md original para o diretório result／archive após a conversão)
auto_renomear	falso	Tratamento de nomes de arquivos conflitantes: true renomear automaticamente; false para substituir o arquivo anterior;

Observação:

• Se os requisitos de personalização não forem altos, é recomendável alterar theme_color e o restante poderá usar a configuração padrão.
• A versão atual da UI do WeChat parece exibir apenas o estilo padrão para todos os números da lista. Mesmo que o estilo seja escrito no elemento de nível superior, ele será "desbotado" quando colado no editor. ignore esta restrição, então adicione a opção convert_list como uma solução temporária. Quando esta opção for true , todas as listas no corpo (excluindo o conteúdo dos blocos de código) serão convertidas em parágrafos comuns com números de série no início do parágrafo. Observe que, neste caso, os estilos definidos especificamente para a lista em styles.less serão inválidos. Se você tiver uma maneira melhor, abra um problema e me avise.

Mais personalização

Se quiser substituir estilos individuais nos estilos padrão, você mesmo pode escrever custom.css , que será importado após default.css .

Exemplo

example.md -> example.html (baixe o html e abra-o no navegador)

Exemplos de artigos de contas públicas: guia completo para formatação MarkDown para contas públicas do WeChat

Use script Python [recomendado]

Se você tiver um ambiente Python instalado em seu computador, poderá executar o script diretamente. Recomenda-se obter a versão estável mais recente do branch Master.

ambiente de desenvolvimento

Desenvolvido em Python 3.5.2, as folhas de estilo CSS são compiladas usando LESS. Recomenda-se usá-lo em ambiente Python 3.

Pacotes dependentes: mistune, premailer, lesscpy

Instale dependências rapidamente: pip install -r requirements.txt

correr

Execute diretamente: python maxpress.py

Ou importe como um módulo:

 import maxpress

maxpress.convert_all(archive=True, styles=None)

Se você deseja abandonar completamente o estilo padrão e ativar uma folha de estilo CSS personalizada, você pode passar o caminho do arquivo CSS personalizado através styles (suporta a passagem em várias listas) e, em seguida, os parâmetros usados ​​para definir o estilo em config.json falhará, custom.css será importado após todas as suas folhas de estilo personalizadas.

Quando uma lista estilizada é colada no editor WeChat, o formato pode ser perdido acidentalmente (parece ser um bug do WeChat? Atualmente, isso pode ser temporariamente resolvido adicionando um estilo de empacotamento de elemento span adicional a cada elemento li ). Mas observe que se você personalizar o estilo, o tamanho da fonte, a cor, etc. definido para li span não pode ser exatamente igual ao elemento de nível superior, caso contrário, ele será removido automaticamente quando colado no editor WeChat.

Exemplo

example.md -> example.html (baixe o html e abra-o no navegador)

Plano de desenvolvimento de acompanhamento

• Opcional para adicionar automaticamente um banner de acompanhamento no início do artigo
• Simplificação e reconstrução de código (não afeta a funcionalidade)
• Suporta configurações de modo de legenda mais diversas no texto
• Suporta conversão direta de postagens do blog Hexo
• Simplifique o processo de personalização de HTML e CSS

Referência

Para ideias de design e alguns estilos padrão, consulte:

• Talvez. Como são formatados os artigos sobre contas públicas?
• Li Xiaolai markdownhere.css
• MDPUB

Licença

MIT