This is the deployed website for the CopeNLU research group, built with Hugo Academic.
If you want to change website content, edit the CopeNLU fork of the Academic Kickstart repository.
Here's a short guide to where what content can be found:
- Profiles for people are in the content/people. Each person is represented with one subfolder. Simply edit Markdown file in the individual subfolder and/or add a new picture. Note that this needs to be called
featured.jpg
orfeatured.png
, otherwise it will not be found. For adding new people, simply copy one of the existing people subfolders and edit. Note that you can add a number of different social links for each person, such as their Google Scholar, Github or personal website. - Blog posts can be found under content/post. Note that in the
index.md
, there is an option for declaring that the blog post is a draft, in that case it will not be displayed. This is useful if you want to work on a post without it being published straight away, content/post/getting-started is an example of this. - Publications can be modified or added under content/publication. As for profiles and blog posts, one subfolder per publication has to be created, and file names should not be changed.
- News can be modified or added under content/talk. As for profiles, blog posts and publications, one subfolder per news item has to be created, and file names should not be changed.
- Docker
- Hugo. Note that the CopeNLU website is only compatible with Hugo >= 0.54.0. To install it, you can e.g. run
docker pull klakegg/hugo:0.54.0
.
- Clone the CopeNLU fork of the Academic Kickstart repository:
git clone https://github.com/copenlu/academic-kickstart.git CopeNLU_Website
- Open a new terminal and navigate to the folder containing this repository. Run
hugo server
, then open a browser window and navigate tohttp://localhost:1313
. - Edit the source code, the website will automatically refresh. If you add new folders or files as opposed to editing existing ones, you sometimes need to restart the server (i.e. terminate the hugo process and type
hugo server
again). If there are errors, an error log will be displayed. Often these are down to small syntax or naming mistakes, so stick to an existing template as closely as possible. - When you are done, follow the instructions on deployment of Hugo Academic to recompile the code and deploy the site. Here's a short version for if you've already done this once:
rm -r public
git submodule add -f -b master https://github.com/copenlu/copenlu.github.io public
git add .
git commit -m "My commit message"
git push -u origin master
hugo
cd public
git add .
git commit -m "My commit message"
git push origin master
- Clone the CopeNLU fork of the Academic Kickstart repository:
git clone https://github.com/copenlu/academic-kickstart.git CopeNLU_Website
- Open a new terminal and navigate to the folder containing this repository.
- Initialize the public submodule: 1.
rm -rf public
2.git submodule update --init --recursive
- Run
docker run --rm -it -p 1313:1313 -v $(pwd):/src klakegg/hugo:0.54.0 server
, then open a browser window and navigate tohttp://localhost:1313
. - Edit the code, the website will automatically refresh.
- When you are done, push the changes to the code as follows:
rm -r public
git submodule add -f -b master https://github.com/copenlu/copenlu.github.io public
git add .
git commit -m "My commit message"
git push -u origin master
- Now, you also need to push the
public
folder. To do that, you need to run hugo from inside the Docker container. To do that... - Start a hugo Docker container process in the background:
docker run -d --rm -it -p 1313:1313 -v $(pwd):/src klakegg/hugo:0.54.0 server
- Check that the Docker container is actually running:
docker ps
- Copy the CONTAINER_ID, then paste it into this command:
docker exec -it CONTAINER_ID sh
- You are now inside the Docker container
- Run hugo from inside the container:
hugo
- Confirm that there is now a public folder:
ls public
- Exit the Docker container again by pressing Ctrl + A D
- Stop the Docker container:
docker stop CONTAINER_ID
- You can now push the public repository as well:
cd public
git add .
git commit -m "My commit message"
git push origin master