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）

• 如果團隊成員仍然是實驗室成員，則數字的格式應為{01/18 -- }如果團隊成員不再是實驗室成員，則number的格式應為{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