blog doc space
v5.4.1
O Node.JS CMS & SSG mais simples!
Uma pequena chama na escuridão do erro ...
Importante
Esta documentação não representa mais os diversos recursos do blog-doc. Por favor, consulte a documentação abrangente para obter informações atualizadas sobre as funcionalidades do Blog-Doc.
Para instalar o Blog-Doc on Space, lidera sua página de instalação e clique no botão Install App .
Depois de instalado, abra o aplicativo do seu horizonte ou acessando a instância do construtor do aplicativo e clicando no botão Open Builder Instance .
Você será redirecionado para o endereço do aplicativo e verá no seu navegador a seguinte mensagem: Route Not Found .
Por favor, não surte! Eu tentei algumas outras maneiras, mas essa é a mais simples e segura.
Agora, assumindo que sua instância do Blog-Doc tem o seguinte endereço:
https://abc-1-x234.deta.app , na barra de endereço do seu navegador.
Adicionar depois dele /admin-blog-doc-config , o endereço está agora:
https://abc-1-x234.deta.app/admin-blog-doc-config , HIT ENTER.
Você será redirecionado para uma página que o guiará na definição da configuração principal para começar a usar o blog-DOC, 2 etapas fáceis de 2 minutos.
No final, você enviará um formulário, leva no máximo 30 segundos para fazer o upload da configuração e será redirecionado para o endereço inicial https://abc-1-x234.deta.app e veja mais uma vez: Route Not Found .
Novamente não entre em pânico! Basta adicionar `/páginas/documentação``, após o endereço. Navegue dentro do aplicativo por um minuto (hora de o código interagir com a unidade recém-criada) sem visitar a rota doméstica, depois vá para a rota principal e comece a usar sua própria instância do blog-doc?
Se não funcionar desde a primeira vez, faça -o novamente mais uma vez e acontecerá.
siteURL antes de implantar o aplicativo.
NOTA BENE: O URL vivo deve terminar com uma barra /
Obviamente, você também deve modificar siteTitle , siteDescription e rssCopyright na página Configurações.
Você deve substituir os valores siteTitle , siteDescription e rssCopyright pelos outros do seu site.
Você pode substituir o valor rssSiteLanguage pelo idioma do seu site.
Uma lista dos códigos de idiomas disponíveis pode ser encontrada na página Códigos de Idioma RSS.
⬆️ de volta aos recursos
Como o feed RSS, você deve fornecer o URL vivo do seu site na página Configurações modificando o valor siteURL para gerar os links corretos para cada página, postar, tag e modelo, bem como para as rotas do blog.
Lembre -se de que o URL do site deve terminar com uma barra /
Você pode verificar o mapa do site do seu site na rota /sitemap .
⬆️ de volta aos recursos
O blog-doutorado possui um recurso de pesquisa interno.
A funcionalidade de pesquisa permite que um usuário faça uma pesquisa sobre os títulos e o conteúdo das postagens.
Você pode verificar a pesquisa do seu site na rota /search .
Você pode desativar a pesquisa no aplicativo Node.js, bem como para o site estático gerado, fornecendo searchFeature um valor de false na página Configurações do site.
⬆️ de volta aos recursos
O blog-docha usa Highlight.js para destacar o bloco de código .
Para escrever código embutido , envolva seu código com backticks `` .
Para destacá -lo, forneça o idioma para o código embutido , colocando depois de um aparelho encaracolado com o alias do idioma do código.
Os exemplos a seguir lhe darão uma ideia melhor.
Supondo que essa linha css p : color { red } , para destacá -la, você escreverá `p { color: red }`{language=css} .
O código é cercado por backsticks `` e seguido por {language=alias of code language} .
Para escrever um bloco de código , envolva seu bloco com um par de 3 backsticks ``` .
Para destacá -lo, forneça o alias do idioma para o bloco logo após os três primeiros backsticks.
Vamos pegar o exemplo anterior e destacá -lo como um bloco:
```css
p { color: red }
```
Vamos obter a seguinte saída:
p {
color : red;
}Visite os idiomas suportados do Highlight.js para obter o alias correto, se não tiver certeza.
Como alternativa, você pode escrever um bloco de código sem fornecer um pseudônimo, o destaque.js detectará automaticamente o idioma.
Se o marcador não detectar o idioma correto para um bloco de código sem um alias, basta adicionar o idioma desejado ao bloco, conforme indicado acima.
⬆️ de volta aos recursos
Adicionando um atributo id a uma tag de título, apenas H2 THE H4, é um recurso ativado opcional por padrão.
Esse recurso foi construído com casos de borda e digitando erros de digitação em mente:
Para adicionar um id , adicione um aparelho encaracolado com uma hashtag seguida pelo texto do ID.
Os exemplos a seguir lhe darão uma ideia melhor:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 > Todo espaço em branco é substituído automaticamente por um hífen e qualquer número de hífens consecutivos é substituído apenas por um hífen.
Qualquer número de hífen no início ou no final do texto do ID é removido, para que o seguinte também seja válido:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >Qualquer coisa antes da última hashtag é ignorada e os personagens especiais no texto do ID também são ignorados:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)Como exemplo:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 > Se você deseja desativar esse recurso, defina o valor addIdsToHeadings como false na página Configurações do site.
⬆️ de volta aos recursos
Desde que o blog-DOC se transformou em um CMS, planejei adicionar uma galeria e uma maneira de recuperar imagens para as páginas e postagens diretamente.
Agora está quase pronto. Quase, porque sempre há espaço para trazer melhorias.
Por enquanto, você pode visitar a galeria pressionando a rota /admin/gallery/images ou vá para a página de administração e clique no link da galeria no menu ou no cartão.
No espírito global do blog-doc, a cozinha é bastante simples de usar.
Você encontrará uma zona de gota onde pode soltar suas imagens ou clicar nela e escolher a (s) imagem (s) que deseja fazer upload.
Você também pode excluir uma imagem da galeria clicando no botão ✘ Excluir .
Por fim, para atribuir uma imagem a uma página ou postagem, você pode, ao criar ou atualizar, escolha uma imagem da galeria selecionando -a diretamente na página ou na postagem.
⬆️ de volta aos recursos
(em breve para o espaço)
Você pode alternar entre os temas e escolher o design que obtém suas necessidades.
O blog-doc vem com:
Se uma imagem vale mais que mil palavras, um vídeo vale um milhão!
Um vídeo de 30 segundos mostrando a capacidade de alterar instantaneamente a aparência do seu site com o blog-doc.
Estarei adicionando mais temas ao blog-Doc ao longo do tempo.
Se você codificou um tema para o blog-doc e deseja listá-lo entre os temas disponíveis, você pode me informar nas discussões sobre o repositório do blog-doutorado na categoria de idéias.
Lembre-se de que os temas-documentos do blog devem usar apenas JavaScript simples e não podem conter nenhum código ou imagem que tenha restrições de publicação e/ou distribuição!
⬆️ de volta aos recursos
Com todo o respeito ao tempo e ao trabalho árduo de todos os desenvolvedores que fizeram um gerador de sites estáticos com o Node.js, incluindo as versões anteriores do blog-doc , esses são Gasworks!
Ofereço desculpas sinceras antecipadamente a cada um desses desenvolvedores, mas um aplicativo não deve ser um Gasworks ...
Embora as postagens a seguir não sejam mais relevantes para a versão real do blog-doc, elas explicam muito bem minha motivação e podem chocá-lo.
Por favor, leia de 145 a 7?
Leia também o novo blog-doc
Leia também Node_modules não é pesado, os desenvolvedores são preguiçosos!
O Blog-Doc for Space agora usa apenas 14 módulos (1916,1 kb ou 1,9161 MB) em vez de 131 (10082 kb ou 10,082 Mb)!
Vá para a página de problemas do espaço do blog-doc no Github e crie uma nova edição, explicando o máximo possível o problema que você está enfrentando.
Vá para as idéias do espaço do blog-doc no Github e conte-me sobre isso.
Incluir o SSG no blog-Doc on Space requer algumas modificações de arquitetura.
Considerarei mais tarde incluir o SSG ou não, dependendo do uso e dos requisitos do Blog-Doc no espaço.
Leia a seção de instalação.
Pretendo fazer muitas melhorias neste aplicativo no meu curto tempo livre.
Você pode tomar o blog-doc como um protótipo e modificá-lo totalmente para usá-lo com outro design e/ou outro idioma de modelo.
Eu realmente espero que este aplicativo seja útil de alguma forma para muitas pessoas por aí, estou considerando isso como minha contribuição pessoal para as comunidades Node.Js e Markdown.
Idéias, comentários e sugestões são muito bem -vindos.
Sya, Lebcit
Construído com ❤️ by lebcit
