pep-dortmund / homepage

Our new homepage

homepage

Repository of the PeP al. homepage (https://pep-dortmund.org).

Contributing

See Contributing for detailled explanation how to

• write new posts
• add static pages
• edit the navigation
• minified markdown intro
• other crazy things

Local Testing

It is advisable, that you test the website locally if you make any changes or review Pull Requests

Install the required software

Ubuntu

$ sudo apt install ruby-dev nodejs libxml2-dev libxslt-dev build-essential
$ gem install --user bundler

And add this to your ~/.bashrc ~/.zshrc ~/.profile/...:

export GEM_HOME="$(ruby -e 'puts Gem.user_dir')"
export PATH="$PATH:$GEM_HOME/bin"

ArchLinux

$ sudo pacman -S ruby nodejs libxml2 libxslt
$ gem install --user bundler

And add this to your ~/.bashrc ~/.zshrc ~/.profile/...:

export GEM_HOME="$(ruby -e 'puts Gem.user_dir')"
export PATH="$PATH:$GEM_HOME/bin"

macOS

$ brew install ruby node
$ gem install bundler

Testing

Go to the base directory of this repository.

First install all required gems

$ bundle config set --local path 'vendor/bundle'
$ bundle install

In order to test the site at this point, simply run

$ bundle exec jekyll serve

The website is then served at localhost:4000. Changes to the inputfiles are recognised and the website is build again, press f5 in the browser to update.

Some updates, like changing images might require to delete the cache (ctrl + r in chrome).

homepage's Issues

Button "More" for timeline

Home only shows 4 posts, maybe we would like to have a "More" button, to see older posts?

Archive

I'm not sure whether its a good idea to add another link in the navigation for this. It'll be pretty wide

Photos of Vorstand

What about the photos? How should we do them?

I implemented for each position now dummy photos.
Rows with just 2 or 1 person may look a little bit ugly.
Is it possible to center them somehow?
My solutions did not work.

Category Icons

• Short Term: Hover text for icons
• Long Term: Design own icons for categories

Size of drop down menu

Changing name from "Protokolle der MV" to "Mitgliederversammlung" doesn't resize the drop down menue. It should be dynamically resized in case of adding or changing some points.

Design TODO

• Add Xing button in footer
• Darker grey for navigation bar
• Finalize content texts on static pages
• Finalize static page box design

Non-optimal description in tab name in browser

When visiting the "Home" of the website the tab name in the browser says "Index". Maybe this could be changed to "PeP et al. e.V.". For every other sub-page this seems to work fine.

No seperate page for single posts

When clicking on a truncated post on the main page, there shouldn't be a seperate site with just one single post.
Instead, the category site should be openend and scrolled to the clicked post position.

title picture

I don't think that a picture which comes from the latest post is the optimal solution for our homepage.
We don't create regularly enough new posts in order to have also changing title pictures. This will lead to title pictures which only represent very few of our actions in PeP et al. and not all of what is and should constitute PeP et al. Also with the button in the center of the picture it has to be chosen very carefully to "look nice". To avoid discussions about what is nice and what isn't we should think about something different.
I could imagine two solutions which serve us in a better way (but I'm surely open for other new ideas ;) ):

• having for all our activities in "vereinsleben" one representative pictures which give us a pool of pictures from which the shown one is chosen randomly
• creating a collage with pictures of all this activities and have this as a standard title picture

Push new posts to our social networks

Would be cool to automate this.

Static pages

Despite a blog system for publishing news I would also like to have some static pages for semi-permanent information and project related stuff :)

Link to the Soak-special not working.

The link of "Reinschauen" on the title page leads to an 404.

Mit welchem Themengebiet beschäftigst Du dich? - Translate project to german?

@beckstev Should the text describing the topics be in German?

How should the Calendar look like

While this is probably not mandatory for release, we should discuss how the Calendar in "Veranstaltungen" might look like. @Vanessa-Mueller

Use git lfs for pdfs and images?

This might be better and help keep the source repo clean.

Bank account info

The image with the bank account info needs to be adapted. It is a bit blurry and is not of the right size for posts.

Content size does not match breakpoints

At some breakpoints, the width of the container-main-div doesn't match the breakpoint width. This leads to ugly horizontal scrollbars from time to time.

Zeitliche Anordnung der Posts auf der Startseite

Die beiden oberen Posts sollten die neuesten sein, also von links nach rechts zeitlich angeordnet.

Anmeldung/Datenbank/Homepage trennen

Ich würde ich mich dafür aussprechen die drei Dinge voneinander zu trennen. Für die Anmeldung siehe: https://github.com/pep-dortmund/pars/blob/master/PRD.md

Make images clickable

I think it would be handy, if the images of "special" posts are clickable.

Blog

I would like to have a blog system :)

Installationsanleitung auf ubuntu

recht lückenhaft.

different layouts in "Über uns" and "Vereinsleben"

In "Vereinsleben" the descriptions are content, while in "Über uns" descriptions are given in subtitles.

Automatically post to social networks

We could use the Social Network APIs to post to our Facebook, XING, and LinkedIn feeds. We could add a token to the yaml head in the posts to decide which one should be shared to which network. We probably need some kind of dumb database on the server-side to prevent reposting everything while building a new version.

Just for reference:

• https://developers.facebook.com/docs/graph-api/reference/post#publishing

Add Anmeldeformular to Homepage

There is no possibility to find our Anmeldeformular on our Homepage. It should be located under Mitmachen

Firmenlogo in Jobbörse

Wenn wir in die Posts für die Jobbörse ein Firmenlogo packen, sieht man auf den ersten Blick von wem das Angebot kommt und alles wird ein bisschen bunter.

👍 oder 👎 ?

Link Special category kaputt

/archive.html' not found.

Content Stipendien

The markdown file stipendien.md needs some small corrections.
In line 7 and 32 linebreaks are missing to separate between the heading and
the following description

Listen sehen nicht so schön aus

Auf der Startseite sehen Special-Posts mit Listen doof aus.

Multi user support

Despite the fact how the site gets generated (static/dynamic/...) a major wish is multi-user support. If possible also with some basic roles/permissions aka Admin, Editor, Reporter.

Drop down menu for Stipendien

We want to restructure the Stipendien site.
So it is easier to acess/view the new Summer School part.

Site generator

We should agree on a static site generator. We could open the discussion for general web frameworks/CMS but atm I don't see a good reason to use them.

I would advocate going with Hakyll since it's slim and powerful and Igor knows a great deal about it.

Feel free to add your suggestions.

Information check - Going Abroad

• mention - Leisure center, is it free?

• check time you can stay in the USA, after you complete the research project

• do we pay the health insurance for the USA ?

• verify application deadline

• create a QR-Code

Protokoll der Mitgliederversammlung 2016 fehlt

Alumni Portraits

• Durch http://physik.tu-dortmund.de/cms/de/Studium/Zusaetzliche-Beitraege/Alumni-erzaehlen/index.html bin ich gerade auf die Idee gekommen, dass wir solche Alumni-Portraits auch auf die PeP-Homepage packen könnten.

• Das wäre auch ein netter Aufhänger sich mal wieder gezielt an einige Alumni zu wenden um nach einem kurzen Text zu fragen.

• Wie findet ihr die Idee, gebt mir ein 👍 oder ein 👎

• Fühlt sich jemand berufen?

Styleguide

Right now the files are for example indented inconsistently with spaces and tabs.

We should agree on a style guide and follow it.

Any suggestions?

Design category icons

We need to design icons for the categories, please add to the list if I forgot something:

• SoAk
• Absolventenfeier
• Bachelorkolloquium
• Alumni

Missing Impressum

We definitely should have an Impressum somewhere on the website.
Add "Vereinssitz" as picture and not as plain text.

Contact page needed

Archive links of posts fail, if not on first archive page

At the moment (current master at a8d85c8), if you click the flag-button below the landing page posts, you are only redirected to the first archive page, where the corresponding post does not appear. The pagination needs to be included for these links, this is the link that has to be fixed, if I remember correctly.

Missing favicon.ico

[2016-04-03 12:44:46] ERROR/favicon.ico' not found`

Social media integration

We should discuss and (if desired) implement the following features:

• Social media buttons
• Twitter feed integration
• ... (More ideas?)

Vorstandsposten Homepage

Auf unserer Homepage sind die Vorstandsposten noch nicht aktualisiert worden und es müssten noch Fotos von einigen Personen gemacht werden.

Update some "Vorstand" images

See the comments in #104

TODO Documentation

• Complete README.md with
  • How to add a post (detailed explanation of md header, esp. how do categories work)
  • What elements to use for custom pages
  • How to add to or modify the navigation bar
• Add a CONTRIBUTION.md with detailed information for developers

Typo in mailadress

The contact adress of PeP is wrong: it is [email protected], but should be [email protected]. It is right in the impressum, but wrong elsewhere

Allow two or more paragraphs in category heading

Right now, the second paragraph in the category description is rendered in a smaller and italic type.

Can we get rid of this behaviour? I suspect it has something to do with the header p:first-of-type in the css

Language

We should think on how we name stuff and communicate.

I would opt for using english everywhere but the actual content.
This might help us authors to be recognised for this project and others who are planning to setup a similar website.

Reduce websites weight

An initial view of the website costs as much as 3.8MB, where the images of index.html take up almost 3MB. I would suggest to further reduce the image sizes. Maybe we could also use dynamic image loading, depending on the screen size.

Online form for membership

An online form for the membership would be much more convenient.

This will require server side code, so this will probably result in a little web app outside this repo, not unlike PARS