neurodata.io

neurodata.io

Este é o código gerador de site estático para neurodata.io

Pré-requisitos

No mínimo, você precisará das seguintes ferramentas instaladas:

1. Git
2. Crescer

Se você não possui o Grow, você pode instalá-lo usando:

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

ou (de um ambiente virtual)

pip install grow

Observe que o grow ainda não oferece suporte ao Python 3.

Executando o servidor de desenvolvimento

Antes de iniciar o servidor de desenvolvimento, pode ser necessário instalar dependências usadas pelo seu projeto. O comando grow install orienta você nisso e tenta configurar seu ambiente para você.

O comando grow run inicia seu servidor de desenvolvimento. Você pode fazer alterações nos arquivos do projeto e atualizá-los para vê-los refletidos imediatamente.

grow install
grow run

Prédio

Você pode usar o comando grow build para construir todo o seu site no diretório build . Esta é uma boa maneira de testar e verificar o código gerado.

grow build

Contribuindo

Envie solicitações pull para deploy a ramificação.

[DEV/QC] Ficheiros e referências bib

Existe um arquivo LaTeX que irá construir as referências em um PDF, principalmente para controle de qualidade. Ele está localizado no diretório raiz e pode ser compilado executando make no diretório raiz.

Rubrica de adição de babador

Ao adicionar uma nova adição aos arquivos bib, a maioria das entradas normais de bib funcionarão, sendo a única etapa adicional a adição de um valor keywords . Quais palavras-chave devem ser usadas para cada arquivo bib são exibidas abaixo, conforme são usadas para organizar o arquivo. Regras gerais:

• Ao adicionar entradas aos arquivos pubs.bib ou talks.bib, inclua uma entrada chamada author+an , isso serve para sublinhar os membros do laboratório e colocar o nome de jovo em negrito nas seções de publicação de seu currículo. Observando a ordem dos autores para uma inscrição no peito, numere quais autores são membros do laboratório ( trainee ) e quais são jovo ( highlight ). Por exemplo:

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

• NÃO adicione uma citação @incollection a menos que esteja adicionando um novo membro ao arquivo people.bib
• Certifique-se de que month seja um número inteiro, pois isso evita possíveis problemas de pedido
• Evite símbolos como & e $ em suas entradas, pois eles podem causar problemas na compilação do bib

Categorias para pubs.bib:

• Para artigos aceitos e publicados com revisão por pares: peer-reviewed
• Para artigos atualmente em revisão: in-review
• Para trabalhos de conferência: conference
• Para entradas de livro: book
• Para relatórios técnicos: tech
• Para resumos/pôsteres: abspos
• Para outras publicações: other
• Para artigos sem Jovo como autor, mas ainda referenciados no site: omit

categorias para talks.bib:

• Para palestras locais: local
• Para negociações internacionais: international

Categorias para press.bib:

• N / D

Informações de adição de membro da equipe

Todas as informações sobre os membros da equipe da página neurodata.io/about/team/ do site e do currículo de Jovo (neurodata.io/about/jovo, a seção de mentoria) são derivadas do arquivo bib localizado em content/bibs/people.bib . É muito importante que todos mantenham suas informações pessoais atualizadas, pois isso estará refletido no currículo do Jovo. Além das informações adicionadas aqui, você precisará enviar uma imagem para content/source/images/people e indicar seu nome na categoria file (por exemplo, john_doe.jpg ). Veja abaixo se deseja adicionar ao site alguém que não deveria aparecer no currículo ou na página do Teams.

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

Algumas categorias podem ser deixadas em branco se não forem aplicáveis. As categorias necessárias para conter informações são: <ID> , author , usera , month , year , number e userd . Mais algumas notas:

• As abreviaturas são fortemente encorajadas para userb e userc

• year e series devem ter todos os 4 dígitos do ano (ou seja, 2019, não 19)

• number deve estar no formato {01/18 -- } se o membro da equipe ainda for membro do laboratório e {01/18 -- 04/21} se ele não for mais membro.

• As categorias para userd são (em ordem de colocação na página de equipes):

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

• As categorias de keywords são:

  • Orientação do corpo docente do curso de pesquisa = corpo docente do curso researchtrackfaculty
  • Cientista pesquisador da equipe = staffresearch
  • Pós-doutorado = postdoc
  • Ph.D. Aluno = PhDstudent
  • Aluno Visitante de Doutorado = visitingdoc
  • Aluno de mestrado = estudante MSstudent
  • Estudante de graduação = undergrad
  • Aluno do ensino médio = HS

• Sua imagem pode ser encontrada aqui () se você já estiver no site

• As entradas usere atualmente suportadas são:

  • safe-zone

Um exemplo de entrada é:

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

Adicionar alguém que não deveria aparecer na página do Teams ou no currículo:

Para isso, basta copiar o verbete abaixo (sim, deve haver espaços nas seções de number e series ) e alterar as informações relevantes. A other especificação para userd e keywords diz ao site para ignorar a exibição dessas pessoas na página do Teams (embora elas apareçam quando referenciadas em outro lugar) e para o currículo ignorá-las na geração.

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

Hospedagem de arquivos no site:

ATUALMENTE EM DESENVOLVIMENTO

Compilando a versão em pdf do CV para a página pessoal do Jovo:

Você pode compilar o pdf localmente executando o comando pdflatex no arquivo jovo_cv_SOM.tex em content/bibs/tex/ . Se você fez alguma alteração nos arquivos bib, também precisará executar o comando biber no arquivo jovo_cv_SOM :

 biber jovo_cv_SOM
pdflatex jovo_cv_SOM.tex