neurodata.io

neurodata.io

นี่คือโค้ดตัวสร้างไซต์แบบคงที่สำหรับ neurodata.io

ข้อกำหนดเบื้องต้น

อย่างน้อยที่สุด คุณจะต้องติดตั้งเครื่องมือต่อไปนี้:

1. คอมไพล์
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] ไฟล์ Bib และข้อมูลอ้างอิง

มีไฟล์ LaTeX ที่จะสร้างข้อมูลอ้างอิงเป็น PDF ซึ่งส่วนใหญ่ใช้สำหรับ QC ตั้งอยู่ในไดเร็กทอรีรากและสามารถสร้างได้โดยการรัน make ในไดเร็กทอรีราก

รูบริกการเพิ่มผ้ากันเปื้อน

เมื่อเพิ่มส่วนเพิ่มเติมใหม่ให้กับไฟล์ bib รายการ bib ปกติส่วนใหญ่จะใช้งานได้ โดยมีขั้นตอนเพิ่มเติมเพียงขั้นตอนเดียวคือการเพิ่มค่า keywords คำหลักใดควรใช้สำหรับไฟล์ bib แต่ละไฟล์จะแสดงอยู่ด้านล่าง เนื่องจากใช้ในการจัดระเบียบไฟล์ กฎทั่วไป:

• เมื่อเพิ่มรายการลงในไฟล์ pubs.bib หรือ talks.bib ให้รวมรายการที่เรียกว่า author+an ซึ่งจะทำหน้าที่ขีดเส้นใต้สมาชิกห้องปฏิบัติการและชื่อของ jovo ตัวหนาในส่วนสิ่งพิมพ์ของ CV ของเขา ดูจากลำดับผู้เขียนในการส่ง Bib จำนวนผู้เขียนที่เป็นสมาชิกห้องแล็บ ( 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},
...

• อย่าเพิ่มการอ้างอิง @incollection เว้นแต่คุณจะเพิ่มสมาชิกใหม่ลงในไฟล์ people.bib
• ตรวจสอบให้แน่ใจว่า month นั้นเป็นจำนวนเต็ม เนื่องจากจะป้องกันปัญหาในการสั่งซื้อที่อาจเกิดขึ้น
• หลีกเลี่ยงสัญลักษณ์เช่น & และ $ ในรายการของคุณ เนื่องจากอาจทำให้เกิดปัญหาในการรวบรวมผ้ากันเปื้อน

หมวดหมู่สำหรับ pubs.bib:

• สำหรับเอกสารที่ผ่านการตรวจสอบโดยผู้ทรงคุณวุฒิที่ได้รับการยอมรับและเผยแพร่แล้ว: peer-reviewed
• สำหรับเอกสารที่อยู่ระหว่างการตรวจสอบ: in-review
• สำหรับเอกสารการประชุม: conference
• สำหรับรายการหนังสือ: book
• สำหรับรายงานทางเทคนิค: tech
• สำหรับบทคัดย่อ/โปสเตอร์: abspos
• สำหรับสิ่งพิมพ์อื่น ๆ : other
• สำหรับบทความที่ไม่มี Jovo ในฐานะผู้เขียน แต่ยังคงมีการอ้างอิงบนเว็บไซต์: omit

หมวดหมู่สำหรับ talks.bib:

• สำหรับการพูดคุยในท้องถิ่น: local
• สำหรับการพูดคุยระหว่างประเทศ: international

หมวดหมู่สำหรับ press.bib:

• ไม่มี

ข้อมูลเพิ่มเติมของสมาชิกในทีม

ข้อมูลทั้งหมดเกี่ยวกับสมาชิกในทีมสำหรับทั้งหน้า neurodata.io/about/team/ ของเว็บไซต์ และ CV ของ Jovo (neurodata.io/about/jovo ส่วนการให้คำปรึกษา) มาจากไฟล์ bib ที่อยู่ใน content/bibs/people.bib . เป็นสิ่งสำคัญมากที่ทุกคนจะต้องรักษาข้อมูลส่วนบุคคลให้ทันสมัยอยู่เสมอ เนื่องจากข้อมูลนี้จะปรากฏใน CV ของ 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}
}

การเพิ่มบุคคลที่ไม่ควรปรากฏในหน้าทีมหรือ CV:

ในการดำเนินการนี้ เพียงคัดลอกรายการด้านล่าง (ใช่ ควรมีช่องว่างในส่วนตัว number และ series ) และเปลี่ยนข้อมูลที่เกี่ยวข้อง ข้อกำหนด other สำหรับทั้ง userd และ keywords บอกให้เว็บไซต์ละเว้นการแสดงบุคคลเหล่านี้บนเพจทีม (แม้ว่าจะปรากฏเมื่อมีการอ้างอิงที่อื่น) และสำหรับ CV ที่จะเพิกเฉยต่อพวกเขาในรุ่นต่อๆ ไป

 @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}
}

การโฮสต์ไฟล์บนเว็บไซต์:

ขณะนี้อยู่ระหว่างการพัฒนา

การรวบรวม CV เวอร์ชัน pdf สำหรับหน้าส่วนตัวของ Jovo:

คุณสามารถคอมไพล์ไฟล์ pdf ในเครื่องได้โดยการรันคำสั่ง pdflatex บนไฟล์ jovo_cv_SOM.tex ใต้ content/bibs/tex/ หากคุณได้ทำการเปลี่ยนแปลงใดๆ กับไฟล์ bib คุณจะต้องรันคำสั่ง biber บนไฟล์ jovo_cv_SOM ด้วยเช่นกัน:

 biber jovo_cv_SOM
pdflatex jovo_cv_SOM.tex