沙龙博客

地址:https://ai-ml.club

大家所做沙龙分享内容,可以通过如下方式上传到我们的博客。

上传地址

https://github.com/BUPT/ai-ml.club/tree/master/docs/_posts

添加作者信息

所有作者的基本资料,都保存在这个文件中:https://github.com/BUPT/ai-ml.club/blob/master/docs/_data/authors.yml

如果你还不在这个文件中的话,那么将自己添加进去即可,如下格式为例:

qhduan:
  name        : "段清华"
  bio         : "人工智障工程师"
  avatar      : "https://avatars0.githubusercontent.com/u/3895924?s=460&v=4"
  links:
    - label: "Website"
      icon: "fas fa-fw fa-link"
      url: "http://qhduan.com"

其中,最核心的就是第一行的 qhduan: 中的 qhduan ,这个是你的作者id,建议与 Github username 保持一致,便于在博客中的 author: qhduan 中需要引用。

其他内容格式可以参考文件中其他部分。

上传格式

  1. 选择论文笔记所属分类(Category),可以参考之前的分类列表
  2. 选择论文笔记所带标签(Tags),可以参考之前的分类列表
  3. 沙龙活动会议纪要命名格式为:XXXX-XX-XX-seminar-meeting-minutes-${season}-${episode}.md。其中${season}是沙龙活动第几季;${episode}是沙龙活动在本季的活动编号,顺序递增。
  4. 论文笔记命名格式为: XXXX-XX-XX-paper-title-in-lower-case.md。”XXXX-XX-XX”为年月日;为了统一规范论文名一律小写。
  5. 上传博客文章所需文件(如图片、PDF等),所有文件都必须存放在docs/assets/${year}/目录下(${year}是四位数字年份)
  6. 所有上传文件,需要符合以下命名规则:
    1. 文件名全部小写,有空格的地方用-连接;
    2. 如果是沙龙活动纪要相关文件,则文件名前缀按照seminar-${season}-${episode}-命名。其中${episode}是沙龙活动的编号
      1. 授蛋仪式照片:seminar-${season}-${episode}-chairman-appointment.jpg
      2. 沙龙演讲照片:seminar-${season}-${episode}-talk-${talker-name}.jpg。其中${talker-name}是演讲人姓名拼音
      3. 合影照片:seminar-${season}-${episode}-group-photo.jpg
    3. 其他文件,尽量文件名和Blog Post的文件名一致,便于后续维护工作识别
  7. 在添加图片到git之前,运行make fit-image将图片尺寸进行调整。

Blog Post 文件模板

最好的模板,就是在目录中寻找之前的博客文章 Markdown 源文件,然后拷贝之后做适合自己的修改。

下面介绍一下基本结构:

---
title: 这里是 Blog 的标题
date: 日期。请按照 "2019-01-06 12:00 +0800" 的格式填写,为了方便可以只修改年月日即可。
author: ${your_github_username}
comments: true
mathjax: true
categories:
  - *
tags:
  - *
  - *
---

Example:

---
title: 胶囊(Capsule)网络
date: 2019-01-06 12:00 +0800
author: 824zzy
comments: true
mathjax: true
categories:
  - classicial paper
tags:
  - capsule
---

嵌入媒体文件

为了让媒体文件的播放器可以自适应浏览器尺寸,并且自动在电脑桌面和手机上都得到良好的限时体验,需要使用如下的 HTML 代码,进行加载。

<div style="
    position: relative;
    padding-bottom:56.25%;
    padding-top:30px;
    height:0;
    overflow:hidden;
">
  <TAG
    width='560'
    height='315'
    allowfullscreen
    webkitallowfullscreen
    frameborder="0"
    style="
      position: absolute;
      top:0;
      left:0;
      width:100%;
      height:100%;
    "
  ></iframe>
</div>

其中,上面代码中的 TAG 可以是:

  1. embed - 如 YouTube 视频嵌入代码
  2. iframe - 如 PDF viewer-js 嵌入代码
  3. video - HTML video 代码
  4. etc.

1. 嵌入 PDF Slides

使用 iframe 作为 TAG ,然后配合上如下 src:

-  <TAG
+  <TAG
+    src='/assets/js/viewer-js/#/assets/2019/slides.pdf`

其中 /assets/2019/slides.pdf 是需要加载的 PDF slides 文件。

发布

对博客的添加修改,可以通过Pull Request的方式提交。Pull Request被Merge之后,在线网站会在几分钟内自动更新。

如有任何疑问,可以联系当任轮值主席或副主席咨询。