www.julialang.org

Readme

Este es el repositorio de GitHub para el sitio web principal de Julia Programming Language, Julialang.org. El repositorio del código fuente del idioma en sí se puede encontrar en github.com/julialang/julia.

El sitio web de Julia se genera con las páginas Github y Franklin.jl, un paquete nativo de Julia para construir sitios web estáticos.

Haciendo cambios simples

Para sugerir un cambio en el sitio web, simplemente puede navegar a la página con el contenido que cree que debe cambiarse y editarlo. Se le solicitará que bifurque el repositorio (si aún no lo ha hecho) y luego abra una solicitud de extracción. Una vez que se fusione su solicitud de extracción, debería ver que sus cambios aparecen en el sitio web en unos minutos o menos.

Las vistas previas de compilación para cada solicitud de extracción se vincularán en la sección de comentarios del PR una vez que el sitio se haya construido con éxito.

Nota : Solo use bloques de código vallados (es decir, bloques de código delimitados por backticks) y no bloques de código sangrados.

Haciendo cambios más complejos

Para sugerir un cambio en el sitio web que sea más significativo, se sugiere que realice dichos cambios y los pruebe localmente en su dispositivo. Puede hacerlo simplemente bifurcando el repositorio base, clonándolo localmente en su dispositivo, realizando los cambios que desea y luego siguiendo las instrucciones de "Instalación localmente" a continuación.

Una vez que haya validado que todo se ve bien, puede abrir una solicitud de extracción y verificar la vista previa de implementación desde Netlify como una verificación final de cordura.

Las vistas previas de compilación para cada solicitud de extracción están disponibles en: https://julialang.netlify.app (tenga en cuenta que, dado el diseño de acciones de GitHub, las vistas previas de compilación solo están disponibles para aquellos que tienen acceso de escritura al repositorio).

Hacer modificaciones y ver los cambios localmente

Clonar el repositorio y cd para él. Iniciar Julia Versión 1.10 con julia --project and Do

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 a localhost:8000 en un navegador y debería ver una vista previa de cualquier modificación que realice localmente.

Modificación del CSS : Modifique los archivos relevantes en _css/ .

Modificación de la estructura HTML : si desea modificar el Navbar, o el pie de página, vaya a _layout/ y modifique el fragmento de plantilla relevante.

Modificación de la página de destino : dado que la página de destino tiene su propio diseño, está escrito en HTML con algunas inserciones de fragmentos replicables cuando corresponda, simplemente modifique index.html

Agregar una publicación de blog

Siga el plan de las muchas otras publicaciones de blog en términos de estructura de carpetas y estructura de archivos. Una cosa importante a tener en cuenta es que RSS es un poco exigente en términos de lo que puede aceptar, así que ten cuidado con lo que entra

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

En particular:

• Evite el uso de & , por ejemplo, cambie ML&PL a ML-PL ,
• Solo use texto plano en rss , sin enlaces, sin marcado, sin entidades HTML.

En caso de duda, después de ejecutar el servidor de Franklin, copie el contenido de __site/feed.xml en el validador de alimentación W3, debería mostrar "Feed RSS válido".

Metadatos

Para agregar <meta aaa="bbb" content="ccc"> etiquetas en su publicación de blog, agregar

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

(Puede especificar varias etiquetas, por supuesto). Vea, por ejemplo, la reciente publicación de blog de Keno.

Buscando enlaces rotos

De vez en cuando, uno debe hacer una verificación en profundidad de que no hay enlaces rotos. Si bien Franklin ofrece una forma rápida de hacer esto, es una buena idea hacer esto en profundidad de vez en cuando. El paquete Broken-Link-Checker es una forma bastante buena de hacer esto. Después de instalarlo con npm , solo haga

 blc https://julialang.org -ro

(Toma un tiempo y puede requerir que lo haga en varios pasos).

Agregar idiomas para resaltar sintaxis

Franklin usa destacado.js para resaltar de sintaxis. Para agregar un nuevo idioma a la biblioteca utilizada por esta página web, vuelva a compilar la biblioteca y agregar un nuevo idioma a la lista. Desde la raíz del resaltado.js Repo:

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

Copie la biblioteca de build/highlight.min.js a _libs/highlight/highlight.min.js en este repositorio.

Crear vistas previas en Netlify

Actualmente, las vistas previas de compilación se ejecutan a través de la cuenta Netlify de Logan Kilpatrick. Si la cuenta se desconecta y las vistas previas ya no están disponibles, todo lo que necesita hacer para restaurarla es registrarse para NetLify, importar un repositorio GIT (este repositorio), seleccione la rama "GH-Preview" y luego haga el subdominio personalizado "julialang.netlify.com". Luego debería poder construir las vistas previas en consecuencia.

Preguntas frecuentes

listas apretadas

Este es principalmente un artículo heredado. Si las listas se ven mal en la página, abra un problema. Ya no debería tener que usar @@tight-list ... @@ .

Si desea listas anidadas, asegúrese de que la sangría de la lista anidada esté realizada con espacios y no con pestañas.