Gere páginas da web a partir de Markdown com Docsify-This

Você está interessado em aproveitar o Markdown para conteúdo online sem qualquer configuração de site ou processo de construção? Que tal incorporar Markdown ou HTML sem restrições em múltiplas plataformas (como um sistema de gerenciamento de conteúdo ou sistema de gerenciamento de aprendizagem)? O projeto de código aberto Docsify-Istoconstruído com Docsify.jsfornece uma maneira fácil de publicar, compartilhar e reutilizar conteúdo Markdown.

(Obtenha a folha de dicas do Markdown)

O que é Docsify-This?

Com Docsify-This, você pode transformar instantaneamente qualquer arquivo Markdown disponível publicamente em uma página da web autônoma e responsiva. Você também pode vincular vários arquivos Markdown para criar um site simples. Os designers podem alterar a aparência visual das páginas exibidas com a interface do Web Page Builder do tipo apontar e clicar ou parâmetros de URL. Você também pode usar um conjunto de classes CSS Markdown fornecidas ao criar seu próprio conteúdo Markdown. Além disso, se você usar Codeberg ou GitHub para armazenar seus arquivos Markdown, um Edite esta página o link pode ser fornecido automaticamente para cada página para oferecer suporte à autoria colaborativa.

É de código aberto, então você pode hospedar uma instância Docsify-This usando seu próprio domínio personalizado sem o risco de aprisionamento de plataforma.

Use o construtor de páginas da Web Docsify-This

Para usar o Web Page Builder, abra um navegador e navegue até o Docsify-Este site ou sua instância local. No Construtor de páginas da web seção, insira o URL de um arquivo Markdown em um repositório público do Codeberg ou GitHub (outros hosts Git também podem ser usados ​​​​por meio dos parâmetros Docsify-This URL, mas não no Web Page Builder) e, em seguida, clique no botão Publicar como página da Web independente botão.

O arquivo Markdown é renderizado como uma página da web independente com um URL que você pode copiar e compartilhar. Aqui está um exemplo de URL:

https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-this-one-page-article/main&homepage=home.md

As páginas da web renderizadas do Docsify-This são perfeitas para incorporação, com a capacidade de estilizar visualmente as páginas do Docsify-This para a plataforma de destino.

Renderizar outros arquivos no mesmo repositório

Você pode renderizar outros arquivos Markdown no mesmo repositório editando diretamente o parâmetro Docsify-This URL página inicial. Por exemplo:

https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-this-one-page-article/main&homepage=anotherfile.md

Modifique a aparência da página da web

Você pode alterar a aparência de qualquer arquivo Markdown exibido no Docsify-This usando Parâmetros de URL. Por exemplo, font-family, font-size, link-colore line-height são todos atributos CSS comuns e são parâmetros válidos para Docsify-This:

https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-this-one-page-article/main&homepage=home.md&font-family=Open%20Sans,sans-serif

Você também pode alterar a aparência visual usando um conjunto de ferramentas especiais Classes CSS Markdown. Por exemplo, você pode adicionar o button classe para um link:

(Required Reading Quiz due Jun 4th)(https://canvas.sfu.ca/courses/44038/quizzes/166553 ':class=button')  

Isso produz uma imagem de botão em vez de apenas um link de texto:

Além das classes CSS Markdown suportadas pelo Docsify-This, você pode definir suas próprias classes personalizadas nos arquivos Markdown exibidos. Por exemplo:

(Custom CSS Class Button)(# ':class=mybutton')

Produz isso:

Incluir trechos de HTML

Conforme suportado pelo Markdown padrão, você pode incluir trechos de HTML. Isso permite adicionar elementos de layout à sua renderização HTML. Por exemplo:

Lorem ipsum dolor sit amet, consectetur adipiscing elit.




Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Incorporar Docsify-This como um iFrame

Você pode incorporar páginas da web Docsify-This usando um iFrame em praticamente qualquer plataforma. Você também pode usar parâmetros de URL para garantir que seu conteúdo incorporado corresponda à sua plataforma de destino:

Incorporar Docsify-This com um URL externo

Em certos sistemas de gestão de aprendizagem (LMS), incluindo o Moodle de código aberto e até mesmo o proprietário Telavocê pode vincular páginas da web externas a um menu de navegação do curso e, às vezes, mais. Por exemplo, você pode usar a ferramenta Redirect no Canvas para exibir páginas da web Docsify-This.

url=https://docsify-this.net/?basePath=https://raw.githubusercontent.com/paulhibbitts/cmpt-363-222-pages/main&homepage=resources.md&edit-link=https://github.com/paulhibbitts/cmpt-363-222-pages/blob/main/resources.md&font-family=Lato%20Extended,Lato,Helvetica%20Neue, Helvetica,Arial,sans-serif&font-size=1&hide-credits=true

Integre Docsify-This e Git

Para aproveitar totalmente os benefícios do controle de versão e potencialmente da colaboração usando um recurso opcional Edite esta página link, armazene suas páginas Docsify-This Markdown em um repositório Git no Codeberg ou GitHub. Várias ferramentas de código aberto fornecem uma interface gráfica para Git, incluindo Área de trabalho do GitHub (lançado recentemente como código aberto), Git-Cola e SparkleShare. Os editores de texto VSCode e Pulsar Edit (anteriormente Atom.io) também apresentam integração com Git.

(Obtenha o e-book de dicas e truques do Git)

Publicação Markdown facilitada

Os benefícios da publicação baseada em Markdown estão disponíveis para todos, graças ao Docsify. E graças ao Docsify-This, é mais fácil do que nunca. Experimente no Docsify-Este site.