www.julialang.org

Readme

Este é o repositório do GitHub para o site principal da linguagem de programação de Julia, Julialang.org. O repositório para o código -fonte do próprio idioma pode ser encontrado em github.com/julialang/julia.

O site da Julia é gerado usando o Github Pages e o Franklin.jl, um pacote nativo de Julia para a criação de sites estáticos.

Fazendo mudanças simples

Para sugerir uma alteração no site, você pode simplesmente navegar para a página com o conteúdo que você acha que deve ser alterado e editá -lo. Você será solicitado a bifurcar o repositório (se ainda não o fez) e abrirá uma solicitação de tração. Depois que sua solicitação de tração for mesclada, você verá que suas alterações aparecem no site em alguns minutos ou menos.

As visualizações de construção para cada solicitação de tração serão vinculadas na seção de comentários do PR, assim que o site for construído com sucesso.

NOTA : Use apenas blocos de código cercado (ou seja, blocos de código delimitados por backticks) e não com blocos de código recuados.

Fazendo mudanças mais complexas

Para sugerir uma alteração no site que é mais significativa, sugere -se que você faça as alterações e teste -as localmente no seu dispositivo. Você pode fazer isso simplesmente comprando o repositório base, clonando -o localmente no seu dispositivo, fazendo as alterações desejadas e seguindo as instruções "instalando localmente" abaixo.

Depois de validar que tudo parece bom, você pode abrir uma solicitação de tração e verificar a visualização da implantação do Netlify como uma verificação final da sanidade.

As visualizações de compilação para cada solicitação de tração estão disponíveis em: https://julialang.netlify.app (observe que, dado o design das ações do GitHub, as visualizações de construção estão disponíveis apenas para quem tem acesso ao repo).

Fazendo modificações e vendo as mudanças localmente

Clone o repositório e cd . Inicie Julia versão 1.10 com julia --project e faça

julia > using Pkg; Pkg . instantiate ()

julia > using Franklin

julia > serve ()
→ Initial full pass ...
→ evaluating code [ ... ] (learning / code - examples . md)
→ Starting the server ...
✓ LiveServer listening on https : // localhost : 8000 / ...
  (use CTRL + C to shut down)

Navegue até localhost:8000 em um navegador e você verá uma prévia de quaisquer modificações que fizer localmente.

Modificando o CSS : Modifique os arquivos relevantes em _css/ .

Modificando a estrutura HTML : se você deseja modificar o Navbar ou o rodapé, vá para _layout/ e modifique o fragmento de modelo relevante.

Modificando a página de destino : Como a página de destino possui seu próprio design, ela é escrita em HTML com algumas inserções de fragmentos reaproveólicos, quando apropriado, basta modificar index.html

Adicionando uma postagem no blog

Siga o plano das muitas outras postagens do blog em termos de estrutura de pastas e estrutura de arquivos. Uma coisa importante a ter em mente é que o RSS é um pouco exigente em termos do que pode aceitar, portanto, tenha cuidado com o que vai

• @def rss = ...
• @def title = ...

Em particular:

• Evite o uso de & , por exemplo, altere ML&PL para ML-PL ,
• Use apenas texto simples em rss , sem links, sem marcação, sem entidades HTML.

Em caso de dúvida, depois de executar o servidor de Franklin, copie o conteúdo do __site/feed.xml no validador de feeds W3, ele deve mostrar "feed RSS válido".

Metadados

Para adicionar <meta aaa="bbb" content="ccc"> tags em sua postagem, adicione

 @def meta = [( " aaa " , " bbb " , " ccc " ),]

(Você pode especificar várias tags, é claro). Veja, por exemplo, a recente postagem do blog de Keno.

Procurando por links quebrados

De vez em quando, deve-se fazer uma verificação aprofundada de que não há links quebrados. Embora Franklin ofereça uma maneira rápida de fazer isso, é uma boa ideia fazer isso em profundidade de tempos em tempos. O pacote Broken-Link-Checker é uma maneira bastante interessante de fazer isso. Depois de instalá -lo com npm , basta fazer

 blc https://julialang.org -ro

(leva um tempo e pode exigir que você o faça em várias etapas).

Adicione idiomas para destaque da sintaxe

Franklin usa Highlight.js para destaque da sintaxe. Para adicionar um novo idioma à biblioteca usada por esta página da web, recompile a biblioteca e adicione um novo idioma à lista. Da raiz do repositório destacado.js:

 $ node tools/build.js bash c diff javascript json julia julia-repl plaintext python ruby shell ini yaml

Copie a biblioteca de build/highlight.min.js para _libs/highlight/highlight.min.js neste repositório.

Construir visualizações no netlify

Atualmente, as visualizações de compilação são executadas na conta Netlify de Logan Kilpatrick. Se a conta ficar offline e as visualizações não estiverem mais disponíveis, tudo o que você precisa fazer para restaurá-las é se inscrever no Netlify, importar um repositório Git (este repositório), selecione a ramificação "GH-Preview" e faça o subdomínio personalizado "julialang.netlify.com". Você deve então poder construir as visualizações de acordo.

Perguntas frequentes

listas apertadas

Este é principalmente um item herdado. Se as listas parecerem erradas na página, abra um problema. Você não deve usar @@tight-list ... @@ mais.

Se você deseja listas aninhadas, verifique se o recuo da lista aninhada é feito com espaços e não com guias.