www.julialang.org
1.0.0
Il s'agit du référentiel GitHub pour le site Web principal du langage de programmation Julia, Julialang.org. Le référentiel du code source de la langue lui-même peut être trouvé sur github.com/jualang/julia.
Le site Web de Julia est généré à l'aide de GitHub Pages et Franklin.jl, un package natif de Julia pour la création de sites Web statiques.
Pour suggérer une modification du site Web, vous pouvez simplement accéder à la page avec le contenu qui, selon vous, devrait être modifié et le modifier. Vous serez invité à débarquer le dépôt (si vous ne l'avez pas déjà fait), puis à ouvrir une demande de traction. Une fois votre demande de traction fusionnée, vous devriez voir vos modifications apparaître sur le site Web en quelques minutes ou moins.
Les aperçus de construction pour chaque demande de traction seront liés dans la section des commentaires du PR une fois la construction avec succès.
Remarque : Veuillez utiliser uniquement les blocs de code clôturés (les blocs de code IE délimités par backticks) et non les blocs de code en retrait.
Pour suggérer une modification du site Web plus significative, il est suggéré de faire ces modifications et de les tester localement sur votre appareil. Vous pouvez le faire en fournissant simplement le repo de base, en le clonant localement sur votre appareil, en apportant les modifications que vous souhaitez, puis en suivant les instructions "Installation localement" ci-dessous.
Une fois que vous avez validé que tout semble bon, vous pouvez ouvrir une demande de traction et vérifier l'aperçu du déploiement de Netlify comme vérification finale de la santé mentale.
Les aperçus de construction pour chaque demande de traction sont disponibles sur: https://jualang.netlify.app (notez que, compte tenu de la conception des actions GitHub, les aperçus de construction ne sont disponibles que pour ceux qui ont un accès en écriture au référentiel).
Clone le référentiel et cd . Démarrer Julia version 1.10 avec julia --project et faire
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) Accédez à localhost:8000 dans un navigateur et vous devriez voir un aperçu de toutes les modifications que vous apportez localement.
Modification du CSS : modifiez les fichiers pertinents dans _css/ .
Modification de la structure HTML : si vous souhaitez modifier la barre navale ou le pied de page, rendez-vous sur _layout/ et modifiez le fragment de modèle pertinent.
Modification de la page de destination : Étant donné que la page de destination a sa propre conception, elle est écrite en HTML avec quelques insertions de fragments réutilisables le cas échéant, modifiez simplement index.html
Suivez le plan des nombreux autres articles de blog en termes de structure de dossiers et de structure de fichiers. Une chose importante à garder à l'esprit est que RSS est un peu pointilleux en termes de ce qu'il peut accepter, alors soyez prudent pour ce qui se passe
@def rss = ...@def title = ...En particulier:
& , par exemple Changer ML&PL en ML-PL ,rss , pas de liens, pas de balisage, pas d'entités HTML. En cas de doute, après avoir exécuté le serveur de Franklin, copiez le contenu de __site/feed.xml dans le validateur W3 Feed, il devrait afficher "Feed RSS valide".
Afin d'ajouter <meta aaa="bbb" content="ccc"> balises sur votre article de blog, ajouter
@def meta = [( " aaa " , " bbb " , " ccc " ),](vous pouvez spécifier plusieurs balises bien sûr). Voir par exemple le récent article de blog de Keno.
De temps en temps, il faut faire une vérification approfondie qu'il n'y a pas de liens cassés. Bien que Franklin offre un moyen rapide de le faire, c'est une bonne idée de le faire de temps en temps. Le package de vérification de la liaison brisée est une façon assez soignée de le faire. Après l'avoir installé avec npm , faites simplement
blc https://julialang.org -ro
(Cela prend un certain temps et peut vous obliger à le faire en plusieurs étapes).
Franklin utilise Highlight.js pour la mise en évidence de la syntaxe. Pour ajouter une nouvelle langue à la bibliothèque utilisée par cette page Web, recompilez la bibliothèque et ajoutez une nouvelle langue à la liste. De la racine du highlight.js repo:
$ node tools/build.js bash c diff javascript json julia julia-repl plaintext python ruby shell ini yaml
Copiez la bibliothèque à partir de build/highlight.min.js sur _libs/highlight/highlight.min.js dans ce référentiel.
Actuellement, les aperçus de build sont exécutés via le compte Netlify de Logan Kilpatrick. Si le compte est hors ligne et que les aperçus ne sont plus disponibles, tout ce que vous avez à faire pour les restaurer est de s'inscrire à NetLify, d'importer un référentiel GIT (ce référentiel), de sélectionner la branche "GH-Preview", puis de faire le sous-domaine personnalisé "julialang.netlify.com". Vous devriez alors pouvoir construire les aperçus en conséquence.
Il s'agit principalement d'un élément hérité. Si les listes semblent mal sur la page, veuillez ouvrir un problème. Vous ne devriez plus avoir à utiliser @@tight-list ... @@ .
Si vous voulez des listes imbriquées, assurez-vous que l'indentation de la liste imbriquée est faite avec des espaces et non avec des onglets.
