这是Julia编程语言主要网站Julialang.org的GitHub存储库。语言本身的源代码的存储库可以在github.com/julialang/julia上找到。
Julia网站是使用GitHub页面和Franklin.jl生成的,这是一个用于构建静态网站的朱莉娅本地包装。
为了提出更改网站的更改,您可以简单地使用您认为应该更改内容的内容导航到页面,然后进行编辑。将提示您订购存储库(如果还没有),然后打开拉动请求。合并了拉动请求后,您应该在几分钟或更短的时间内看到更改显示在网站上。
成功构建网站后,将在PR的评论部分链接到每个拉的请求的构建预览。
注意:请仅使用围栏代码块(即由Backticks界定的代码块),而不使用缩进的代码块。
为了建议更改更重要的网站,建议您进行上述更改并在设备上本地进行测试。您可以通过简单地将基本存储库拨打,将其克隆到设备上,进行所需的更改,然后遵循下面的“本地安装”指令来做到这一点。
验证一切看起来不错后,您可以打开拉动请求,并检查Netlify的Deploy Proview作为最终的理智检查。
每个拉请请求的构建预览可在以下网址提供:https://julialang.netlify.app(请注意,给定的github操作设计,构建预览仅适用于那些对repo的写入访问权限的人)。
克隆存储库和cd 。使用Julia启动Julia 1.10版julia --project并做
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
根据文件夹结构和文件结构,请遵循许多其他博客文章的蓝图。要记住的重要一件事是,RSS在可以接受的东西方面有点挑剔
@def rss = ...@def title = ...尤其:
& ,例如将ML&PL更改为ML-PL ,rss中使用纯文本,没有链接,没有标记,没有HTML实体。如有疑问,运行富兰克林的服务器后,将__site/feed.xml的内容复制到W3 feed验证器中,它应显示“有效的RSS feed”。
为了添加<meta aaa="bbb" content="ccc">在您的博客文章中的标签,请添加
@def meta = [( " aaa " , " bbb " , " ccc " ),](当然,您可以指定多个标签)。例如,请参见Keno最近的博客文章。
每隔一段时间,一个人都应该进行深入检查是否没有损坏的链接。尽管富兰克林提供了一种快速的方法来做到这一点,但最好不时地进行深入执行。断开链路检查程序包是一种非常整洁的方法。使用npm安装后,只需做
blc https://julialang.org -ro
(这需要一段时间,可能需要您以几个步骤进行操作)。
富兰克林使用亮点.js进行语法突出显示。要向此网页使用的库中添加新语言,请重新编译库,然后将新语言添加到列表中。从亮点的根源。JSrepo:
$ 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 ... @@ 。
如果您需要嵌套列表,请确保嵌套列表的缩进是用空格制成的,而不是用选项卡制成的。