Skip to content

HDUMIL/summer-school

Repository files navigation

媒体智能实验室暑期班

Media Intelligence Laboratory


All Contributors license Powered by chat on Binder Open In Colab

媒体智能实验室(Media Intelligence Laboratory, MIL) 隶属于杭州电子科技大学计算机学院。原名计算机动画与多媒体分析实验室(Computer Animation and Multimedia Analysis LAB,CAMALAB), 成立于 2014 年。实验室的研究方向为多媒体与机器学习等人工智能相关前沿领域。具体而言,包含:图像检索、跨媒体表达、人脸检测与识别、图像分类/目标识别、图像质量评价、视频理解、图像生成、深度学习等前沿课题。

每年暑期将为新入学研究生安排入门课程,进行基础内容的讲解,并培养相关科研能力。每一期暑期班的讲座内容都会有所差异,请注意当前项目对应的学期时间,你可以找到一份 2017&2018 学期的存档作为参考。

开发人员文档

静态网站基于 GitHub Pages 驱动,使用 Jekyll 引擎渲染,支持 Liquid 语法。

本项目未使用任何 Jekyll 主题和额外插件,大部分网页内容修改只需要基础的 HTML / CSS / JS 前端知识。

项目允许被 Fork, 使用 Clone 功能时建议将 depth 设置为 1,非管理人员发起的 PR 请求会被直接忽略。

本地渲染网站请在根目录运行 jekyll serve 命令,需提前安装和配置 Ruby 和 Jekyll 环境。

如果对当前项目的使用有任何疑问,请发送邮件到 acdoge[dot]cao[at]gmail[dot]com

文件夹结构

_includes/                    # 存放可被重用或作为局部模板的 HTML 文件
  faq.html                    # 常见问题解答
  information.html            # 课程相关信息
  schedule.html               # 课程大纲时间表
  ...
  head.html                   # 网站头信息,多存放 meta 与 CSS
  nav.html                    # 网站导航栏,多存放 navigation
  header.html                 # 网站头部内容,多存放标题与头部图
  footer.html                 # 网站尾部内容,多存放网站说明信息

_layouts/                     # 渲染规则,即网页模板,默认为 default.html
  default.html
  page.html

assets/                       # 统一用于存放静态文件资源
  css/                        # 存放 CSS 层叠样式表文件
  img/                        # 存放 Image 图像文件
  js/                         # 存放 Javascript 脚本

assignments/                  # 存放作业说明与相关文件
notebooks/                    # 存放教程文件,常用于讨论环节
notes/                        # 存放助教或学生提供的笔记
projects/                     # 存放最终学生个人或分组完成的项目
slides/                       # 存放可公开的幻灯片,为讲座对应内容

_config.yml                   # 网站全局设置信息
announcement.md               # 独立页面,使用 Markdown 语法渲染
index.html                    # 网站默认 index 主页,必须设置

文件命名规范:

  • 不得出现中文命名与空格,英文统一小写,使用 - 作为连词符号,框架文件添加 _ 前缀;
  • 资源必须采用资源名词的复数形式,如 notes 而不是 note;
  • 父子目录与文件之间的层级关系不得超过三级,如 /assets/img/favicon.ico 为极限情况;
  • 如果是内容资源的 URL, 需去除尾部参数,如 http://www.domian/com/users.html?id=1 需改为 http://www.domian/com/users/1.

如何修改课程人员信息

_includes/instructor.html 中找到“讲师”或“助教”列表:

<h2 class="module-header">{类型}</h2>

在下方找到合适的顺序位置修改对应信息:

<div class="instructor" id="{name}">
    <a href="{url}" target="_blank">
        <div class="instructorphoto">
            <img class="img-hover" src="{{ "/assets/img/{name}.{jpg/png/...}" | prepend: site.baseurl }}">
        </div>
        <div>{名称}</div>
    </a>
    <br>
</div>

其中 {name} 为姓名信息,{url}为个人主页链接(如果没有可使用 # 代替), {name}.{jpg/png/...} 为需要添加到 assets/img 文件夹下的图片,注意分辨率不能低于 120 * 120 px, 保持图片整体为正方形比例,超过显示大小的会自动进行缩放。

如何修改课程大纲和时间安排

_includes/schedule.html<tbody></tbody> 域内进行修改,例如:

<tr>
    <td>第1列内容</td>
    <td>第2列内容</td>
    <td>第3列内容</td>
    <td>第4列内容</td>
    <td>第5列内容</td>
</tr>

以上为单行信息的修改,也可以根据情况添加新的 <th> 列,并设置列宽 width 比例:

<tr class="active">
    <th style="width:10%;">类型</th>
    <th style="width:12%;">日期</th>
    <th style="width:30%;">主要内容</th>
    <th style="width:30%;">相关材料</th>
    <th style="width:18%;">备注</th>
</tr>

<tr class="active"> 中使用 class 控制表格背景颜色,

也可以在 /assets/css/main.css中自定义新样式,起到想要的视觉效果,

目前已经提供的有 active , info , warningdanger.

为了更好的控制样式,如单元格合并居中等,时间表不推荐使用 Markdown 语法。

如何链接/引用内部文件

由于项目存在 baseurl, 为确保 src 资源路径正确,请统一采用如下写法:

src  = "{{ "/url.file" | prepend: site.baseurl }}"
href = "{{ "/url.file" | prepend: site.baseurl }}"

其中 /url.file 为相对根目录的路径,该语法将网站 baseurl 作为前缀进行了补全。

而在 CSS 等不会被渲染的文件中直接使用资源相对路径即可,如 url("../img/bg-pattern.png").

其它维护说明

Jekyll 引擎支持以 Markdown 语法进行渲染,即使用 .md 文件代替 .html 文件。

想要触发模板渲染机制,请使用 YAML 头写法,例如:

---
layout: default
---

.md 文件中可以混用 Markdown 与 HTML 语法,常用于图片参数,居中等情况。

默认网页渲染格式参考 default.html 文件:

<!DOCTYPE html>
<html lang="{{ page.lang | default: site.lang | default: "zh" }}">

{% include head.html %}

<body>

    {% include header.html %}

    <div class="page-content">
        <div class="wrap">
            {{ content }}
        </div>
    </div>

    {% include footer.html %}

    <!-- JavaScript -->
    <script src="{url}.js"></script>
</body>

</html>

注意事项:

  • 由于 GitHub 服务器在国内不稳定,CSS / JS 文件尽可能使用国内公共 CDN 进行加速;
  • JS 文件通常在 _layouts 网页源码内 footer.html 下方按需加载,加快页面元素显示速度;
  • 由于图片为非二进制文件容易影响 git 体积,建议使用稳定图床,或通过 TinyJPG 网站压缩后上传;
  • 对于类似的非二进制文件,建议使用国内 CDN 进行代理缓存,或提供镜像下载源地址;
  • 请勿在开源过程中,包括 Commits 等记录中泄露个人信息或者保密信息;
  • 关于网页渲染机制的更多说明请查阅 Jekyll 官方文档。

进阶使用

你可以根据实际情况,设计一些新的页面或渲染模板以加强互动性和丰富性。

甚至可以完全脱离 Jekyll 引擎范围,自由地开发新的静态页面(但是不推荐这样做)。

使用协议

本项目使用 MIT 协议,允许二次使用,请勿擅自修改协议内容。

贡献者名单

感谢以下人员为项目发展做出的贡献:

Accepted Doge
Accepted Doge

💻 🎨 💬 🖋 📖 💡 🤔
Fei
Fei

🤔 📋
Zhou Yu
Zhou Yu

🤔 📋
Zjutanmin
Zjutanmin

🤔 📋

Releases

No releases published

Packages

No packages published