neurodata.io

神经数据.io

这是 Neurodata.io 的静态站点生成器代码

先决条件

您至少需要安装以下工具：

1. git
2. 生长

如果您没有 Grow，您可以使用以下命令安装它：

curl https://install.grow.io | bash

或（来自虚拟环境）

pip install grow

请注意，grow 尚不支持 Python 3。

运行开发服务器

在启动开发服务器之前，您可能必须安装项目使用的依赖项。 grow install命令将引导您完成此过程并尝试为您设置环境。

grow run命令启动您的开发服务器。您可以对项目文件进行更改并刷新以立即看到它们的反映。

grow install
grow run

建筑

您可以使用grow build命令将整个站点构建到build目录。这是测试和验证生成的代码的好方法。

grow build

贡献

请提交拉取请求以deploy分支。

[DEV/QC] 书目文件和参考文献

有一个 LaTeX 文件可以将参考文献构建成 PDF，主要用于 QC。它位于根目录下，可以通过在根目录下运行make来构建。

围兜添加标题

当向书目文件添加新内容时，大多数普通书目条目都可以工作，唯一的附加步骤是添加keywords值。下面显示了每个 bib 文件应使用哪些关键字，因为它们用于组织文件。一般规则：

• 将条目添加到 pubs.bib 或 talk.bib 文件时，请包含一个名为author+an的条目，这用于在实验室成员下划线并在简历的出版部分中粗体 jovo 的名字。查看围脖条目的作者顺序，哪些作者是实验室成员（ trainee ），哪些作者是 jovo（ highlight ）。例如：

 @article{example,
author = {<lab member> and <not lab member> and <jovo> and <lab member> and <not lab member>},
author+an = {1=trainee;4=trainee;3=highlight},
...

• 除非您要向people.bib文件添加新成员，否则请勿添加@incollection引用
• 确保该month是整数，因为这可以防止潜在的排序问题
• 避免在条目中使用&和$等符号，因为它们可能会导致围兜编译出现问题

pubs.bib 的类别：

• 对于已接受和发表的同行评审论文： peer-reviewed
• 对于目前正在审查中的论文： in-review
• 对于会议论文： conference
• 对于书籍条目： book
• 技术报告： tech
• 摘要/海报： abspos
• 对于其他出版物： other
• 对于没有 Jovo 作为作者但仍在网站上引用的论文： omit

talk.bib 的类别：

• 对于本地会谈： local
• 对于国际会谈： international

press.bib 的类别：

• 不适用

团队成员添加信息

网站的 Neurodata.io/about/team/ 页面和 Jovo 的简历（neurodata.io/about/jovo，指导部分）的所有有关团队成员的信息均源自位于content/bibs/people.bib中的 bib 文件。每个人保持最新的个人信息非常重要，因为这将反映在 Jovo 的简历中。除了此处添加的信息之外，您还需要将图像上传到content/source/images/people并在file类别中注明其名称（例如john_doe.jpg ）。如果您希望将不应出现在简历或团队页面上的人员添加到网站，请参阅下文。

 @incollection{<ID>,
    author = {Full name},
    usera = {Job title},
    month = {Month, as an integer, that you started working},
    year = {starting year},
    number = {starting month/year -- ending month/year},
    series = {ending year},
    abstract = {What you do in the lab, 1-2 sentences, 3rd person},
    userb = {highest degree held},
    userc = {department/major, school},
    userd = {website category},
    keywords = {cv category},
    doi = {github username},
    note = {email address},
    url = {personal website (do not include https://)},
    usere = {training},
    file = {image name}
}

有些类别如果不适用可以留空，需要包含信息的类别有： <ID> 、 author 、 usera 、 month 、 year 、 number和userd 。更多注意事项：

• 强烈鼓励userb和userc使用缩写

• year和series应包含年份的全部 4 位数字（即 2019 年，而不是 19）

• 如果团队成员仍然是实验室成员，则number的格式应为{01/18 -- }如果团队成员不再是实验室成员，则数字的格式应为{01/18 -- 04/21} 。

• userd的类别是（按照团队页面上的放置顺序）：

  • faculty
  • faculty - research
  • staff
  • postdoc
  • student
  • undergrad
  • associate
  • highschool

• keywords的类别有：

  • 研究轨道教师指导= researchtrackfaculty
  • 职员研究科学家= staffresearch
  • 博士后 = postdoc
  • 博士学生= PhDstudent
  • 访问博士生= visitingdoc
  • 硕士生 = MSstudent
  • 本科生= undergrad
  • 高中生 = HS

• 如果您已经访问该网站，可以在此处 () 找到您的图片

• 当前支持的usere条目有：

  • safe-zone

一个示例条目是：

 @incollection{johndoe,
    author = {John Doe},
    usera = {Research Assistant},
    month = {7},
    year = {2019},
    number = {7/19 -- },
    series = {},
    abstract = {Lead developer on <project>, helping with <something>...},
    userb = {BSE},
    userc = {BME, JHU},
    userd = {student},
    keywords = {MS},
    doi = {jnydoe},
    note = {[email protected]},
    url = {www.heresjohnny.com},
    usere = {safe-zone},
    file = {john_doe.jpg}
}

添加不应出现在“团队”页面或简历上的人员：

为此，只需复制下面的条目（是的， number和series部分中应该有空格）并更改相关信息。 userd和keywords的other规范告诉网站忽略在“团队”页面上显示这些人（尽管他们会在其他地方引用时出现），并让简历在生成时忽略他们。

 @incollection{johndoe,
    author = {John Doe},
    usera = {},
    month = {},
    year = {},
    number = { },
    series = { },
    abstract = {},
    userb = {},
    userc = {},
    userd = {other},
    keywords = {other},
    doi = {},
    note = {[email protected]},
    url = {},
    usere = {},
    file = {john_doe.jpg}
}

在网站上托管文件：

目前正在开发中

为 Jovo 个人页面编译 pdf 版本的简历：

您可以通过在content/bibs/tex/下的jovo_cv_SOM.tex文件上运行pdflatex命令来本地编译 pdf。如果您对 bib 文件进行了任何更改，则还需要对jovo_cv_SOM文件运行biber命令：

 biber jovo_cv_SOM
pdflatex jovo_cv_SOM.tex