Site euroscipy.org

This repository contains the landing page and blog for the site euroscipy.org.

Note: This repository has submodules, clone with:

git clone --recursive <git_url>

Create dev environment with Conda

mamba create -n pelican python=3.7
conda activate pelican
conda install pip
git clone --recursive <git_url> <dest>
cd <dest>
mamba install --file requirements.txt python

Contributing

Currently the website is a set of static pages generated by Pelican. The generated content is uploaded to our server sponsored by Enthought. Contact euroscipy-org@python.org to get things updated.

Please feel free to contribute in what ever capacity you feel best. For now, the site contains details for conferences past and news items from conferences.

Here are a few ways you can contribute:

Add news item

• Fork the repository on GitHub

• Clone the fork

git clone --recursive git@github.com:euroscipy/www.euroscipy.org.git
cd www.euroscipy.org

• Create a new branch with the name of your news item.

• Add your news item in content/news, see Pelican docs for details can be rst or markdown. An example below:

$ cd content/news
>
$ cat << EOF > 2013-10-25-test.md
> Title: Test
> Date: 2013-10-25
> Comments: true
> Categories:
> Author: Andy R. Terrel <andy.terrel@gmail.com>
> Summary: Testing
>
> Testing how this works!
>
> EOF

• Push to your fork on GitHub

• Create a pull request

• Email euroscipy-org@python.org to get the content deployed.

Add or edit a page

• To edit the website one needs to first install the pelican blog system, see Pelican Quickstart

  • be sure to have Markdown installed as well

• Next checkout the source code:

git clone git@github.com:euroscipy/euroscipy.github.io.git
cd euroscipy.github.io

• Editing pages:

  • The content of the page can be found in the content directory

  $ cd content; ls
  > pages static

  • static: content to be copied,

  • pages: the set of pages to be displayed

  • To add a new post, add a file to the news, see pelican docs for the page issues

• Generating and viewing changes

  • Now go to the top dir and regenerate site:

  cd ../../
  make html

  • To view it locally:

$ make serve
>
< open browser to http://127.0.0.1:8000 >
( you should see your test page in the News and archives )
< Ctrl-C to exit server on terminal >

• To create a dev server that reloads content automatically:

$ make devserver
>
< open browser to http://127.0.0.1:8000 >
( you should see your test page in the News and archives , only works for python <= 3.7)
< Ctrl-C to exit server on terminal >

• To modify a page edit inside the pages content

cd content/pages
vi 2018/index.md

• Once again go to top and make it and view

cd ../.. && make html && make serve

• To edit the layout see thing inside the theme

  ls theme
  > tuxlite_zf

  • Be sure to check in your changes and push

  git add <files changed>
  git commit -m “<Describe changes>”
  git push origin <branch-name>

Contact

The site is collaboratively edited by the SciPy Organizers. Please email euroscipy-org@python.org for details.