これは、Juliaプログラミング言語のメインWebサイトJulialang.orgのGithubリポジトリです。言語自体のソースコードのリポジトリは、github.com/julialang/juliaにあります。
JuliaのWebサイトは、Github Pagesと、静的Webサイトを構築するためのJuliaネイティブパッケージであるFranklin.jlを使用して生成されます。
Webサイトの変更を提案するには、変更する必要があると思われるコンテンツを使用してページに移動して編集できます。リポジトリをフォークするように求められます(まだ持っていない場合は)、プルリクエストを開きます。プルリクエストがマージされたら、数分以内にウェブサイトに変更が表示されることがわかります。
各プル要求のビルドプレビューは、サイトが正常に構築されると、PRのコメントセクションにリンクされます。
注:インデントされたコードブロックではなく、フェンスで囲まれたコードブロック(つまり、バックティックで区切られたコードブロック)のみを使用してください。
より重要なウェブサイトへの変更を提案するために、上記の変更を加えてデバイスでローカルでテストすることをお勧めします。これを行うには、ベースリポジトリをフォーキングし、デバイスにローカルにクローニングし、必要な変更を加え、以下の「ローカルにインストールする」指示に従うことができます。
すべてが見栄えが良いことを検証したら、プルリクエストを開き、最終的な正気チェックとしてNetlifyからデプロイプレビューを確認できます。
各プルリクエストのビルドプレビューは、https://julialang.netlify.appで利用できます(githubアクションデザインを考慮して、ビルドプレビューはリポジトリにアクセスできる人のみが利用できます)。
リポジトリとcdをクローンします。 Juliaバージョン1.10を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)ブラウザでlocalhost:8000に移動すると、ローカルで行う変更のプレビューが表示されます。
CSSの変更: _css/の関連ファイルを変更します。
HTML構造の変更:Navbarまたはフッターを変更する場合は、 _layout/に移動し、関連するテンプレートフラグメントを変更します。
ランディングページの変更:ランディングページには独自のデザインがあるため、必要に応じて再利用可能なフラグメントをいくつか挿入することでHTMLに書かれていますindex.html変更するだけです
フォルダー構造とファイル構造の観点から、他の多くのブログ投稿の青写真に従ってください。心に留めておくべき重要なことの1つは、RSSが受け入れることができることの点で少しうるさいので、何が入るかに注意してください。
@def rss = ...@def title = ...特に:
&たとえばML&PLにML-PLに変更してください、rss 、リンク、マークアップなし、HTMLエンティティでのみプレーンテキストを使用します。疑わしい場合は、Franklinのサーバーを実行した後、 __site/feed.xmlのコンテンツをW3 Feed Validatorにコピーすると、「有効なRSSフィード」が表示されます。
ブログ投稿に<meta aaa="bbb" content="ccc">タグを追加するには、追加する
@def meta = [( " aaa " , " bbb " , " ccc " ),](もちろん複数のタグを指定できます)。たとえば、Kenoの最近のブログ投稿をご覧ください。
頻繁に、壊れたリンクがないことを詳細にチェックする必要があります。フランクリンはこれをすばやく提供していますが、時々これを詳細に行うことをお勧めします。壊れたリンクチェッカーパッケージは、これを行うためのかなりきれいな方法です。 npmでインストールした後、Just Do
blc https://julialang.org -ro
(しばらく時間がかかり、いくつかのステップでそれを行う必要がある場合があります)。
Franklinは、Syntax HighlightingにHighlight.jsを使用します。このWebページで使用されるライブラリに新しい言語を追加するには、ライブラリを再コンパイルし、リストに新しい言語を追加します。 highlight.jsリポジトリのルートから:
$ node tools/build.js bash c diff javascript json julia julia-repl plaintext python ruby shell ini yaml
このリポジトリのbuild/highlight.min.jsから_libs/highlight/highlight.min.jsにライブラリをコピーします。
現在、ビルドプレビューはLogan KilpatrickのNetlifyアカウントを介して実行されています。アカウントがオフラインになり、プレビューが使用できなくなった場合、それらを復元するために必要なのは、netlifyにサインアップし、gitリポジトリ(このリポジトリ)をインポートし、「gh-preview」ブランチを選択してから、カスタムサブドメイン「julialang.netlify.com」を作成するだけです。その後、それに応じてプレビューを構築できるはずです。
これは主にレガシーアイテムです。リストがページで間違っているように見える場合は、問題を開いてください。 @@tight-list ... @@使用する必要はありません。
ネストされたリストが必要な場合は、ネストされたリストのインデントがタブではなくスペースで作成されていることを確認してください。