Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Automate listing upcoming events on the index #559

Closed
wants to merge 12 commits into from

Conversation

mvz
Copy link

@mvz mvz commented Oct 5, 2014

Do not merge this yet!

This is a first baby step toward fixing #557. It introduces Jekyll and converts two event pages to being posts. Also, it shows posts that represent upcoming evets on the index page.

To see the result, run jekyll server --watch.

mvz added 6 commits October 4, 2014 20:50
- Move page to posts directory
- Add metadata
- Autogenerate upcoming event entry on index.html
Unlike for a blog, the 'oldest' upcoming event needs to be shown first.
This is a slightly awkward solution, since the 'current' date has to be
set manually in a variable for now.
@FloorD
Copy link
Contributor

FloorD commented Oct 5, 2014

😍

@Lieke22
Copy link
Contributor

Lieke22 commented Oct 5, 2014

That will make it so much easier 😄

@alicetragedy
Copy link
Member

awesome!!!!

@hsbt
Copy link
Member

hsbt commented Oct 5, 2014

How to deploy jekyll's sites into railsgirls.com?

Maybe railsgirls.com are using dedicated server. so, It's not only repository issue. I think we need to change server configuration too.

@lindaliukas
Copy link
Member

Yup - so currently @ksaa knows this system best.

And the other thing is, the documentation and instructions needs to be
super good. This is going to be the first time for a lot of people that
they try out Jekyll or start a server and so on. I'll try to write
something too.

On Sun, Oct 5, 2014 at 2:59 PM, SHIBATA Hiroshi [email protected]
wrote:

How to deploy jekyll's sites into railsgirls.com?

Maybe railsgirls.com are using dedicated server. so, It's not only
repository issue. I think we need to change server configuration too.


Reply to this email directly or view it on GitHub
#559 (comment).

@mvz
Copy link
Author

mvz commented Oct 6, 2014

The general idea is to let jekyll generate the site and then upload the result. So, the server config stays the same, except you upload the contents of _site to it, rather than /.

@mvz
Copy link
Author

mvz commented Oct 6, 2014

Ok, I just looked at deploy.sh (should've looked at it first), and it looks like there will need to be some changes to the server and the whole deploy process.

@Bertg
Copy link

Bertg commented Oct 6, 2014

@mvz @hsbt actually, if vanilla Jekyll is used the site can be completely hosted in Github, even with the custom domain name. I see the current Railsgirls github page is forwarding to the guides page, so this could be an option.
The cool thing that a real deploy would not be needed. Just merge, and it'll be updated by itself.

@lindaliukas
Copy link
Member

That would be super good, would save a lot of confusion and possible broken merges.

On Mon, Oct 6, 2014 at 9:58 AM, Bert Goethals [email protected]
wrote:

@mvz @hsbt actually, if vanilla Jekyll is used the site can be completely hosted in Github, even with the custom domain name. I see the current Railsgirls github page is forwarding to the guides page, so this could be an option.

The cool thing that a real deploy would not be needed. Just merge, and it'll be updated by itself.

Reply to this email directly or view it on GitHub:
#559 (comment)

@Bertg
Copy link

Bertg commented Oct 6, 2014

Yeah. However, shuffling the projects around can be a bit of a hassle. The github site MUST be placed in a repo named railsgirls.github.com http://railsgirls.github.com/.
If we want to do this, this should be well coordinated.

On 06 Oct 2014, at 10:23, Linda [email protected] wrote:

That would be super good, would save a lot of confusion and possible broken merges.

On Mon, Oct 6, 2014 at 9:58 AM, Bert Goethals [email protected]
wrote:

@mvz @hsbt actually, if vanilla Jekyll is used the site can be completely hosted in Github, even with the custom domain name. I see the current Railsgirls github page is forwarding to the guides page, so this could be an option.

The cool thing that a real deploy would not be needed. Just merge, and it'll be updated by itself.

Reply to this email directly or view it on GitHub:
#559 (comment)

Reply to this email directly or view it on GitHub #559 (comment).

@hsbt
Copy link
Member

hsbt commented Oct 6, 2014

The github site MUST be placed in a repo named railsgirls.github.com

railsgirls.github.com is already used by guides.railsgirls.com. We can not use this domain.

@Bertg
Copy link

Bertg commented Oct 6, 2014

@hsbt Actually, I dove a bit deeper into the pages system and noticed that this IS possible. https://help.github.com/articles/user-organization-and-project-pages/

This would make deploying a bit less easy, unless the gh-pages branch would become the default one.

@hsbt
Copy link
Member

hsbt commented Oct 6, 2014

@Bertg Is your consideration following situation?

  • railsgirls.github.com repos => guides.railsgirls.com
  • railsgirls repos => railsgirls.com

@Bertg
Copy link

Bertg commented Oct 7, 2014

@hsbt Yeah, that could work. So we leave the railsgirls.github.com as it is.
We can then serve the Jekyll version of www.railsgirls.com from the gh-pages branch in this repo.

@hsbt
Copy link
Member

hsbt commented Oct 7, 2014

@Bertg www.railsgirls.com? it's chaged from railsgirls.com. I worried it make permelink in railsgirls.com to deadlinks.

PS. I'm not against this PR :octocat:

@mvz
Copy link
Author

mvz commented Oct 7, 2014

Anyone picking up the other points from #557, please feel free to add commits to this branch.

@andreionut
Copy link
Contributor

Great find, @mvz .

I am working on a script that migrates the old pages to the new format, so I'll assign that to me.

@ksaa
Copy link
Member

ksaa commented Oct 7, 2014

My comments:

Right now the site is just a collection of html pages and my server which hosts the railsgirls.com domain just pulls in the content.

It's definitely a hacky system and not that great but it has the advantage that it can't really break, and it's very accessible to different skill levels. You can just copy the html file, make changes with notepad and open it with your browser.

I like Jekyll, and jekyll or middleman has been on the table before. I think some of the problems are however:

  1. You need to install bundler or the correct version of the jekyll, and possibly related gems
  2. One mistake in a file can break the site rendering and jekyll error messages are not that clear
  3. Deployment seems always bit hacky – you need to always remember to pull and render the changes when uploading (otherwise you overwrite the site) or use gh-pages (but they also randomly cache the content and you have no control over it)

One option would be a simple app, where you can submit the event details to a form online and the app generates the event and the event index page.

If we end up going Jekyll, it should be as out-of-the-box as possible and like @lindaliukas said, really good documentation how to use it and how to troubleshoot problems.

@andreionut
Copy link
Contributor

I've did the first part of the migration of the events.
The issues that I see now are related to images and how they fit in their place in the events page. I will take a look at generating consistent size images for that page.
Next step should be the unlinked events and generating the feed and api.

We need to look into the issues raised by @ksaa as this automatic index/events page won't really work unless we generate the site at least once a day.

An app for submissions is a good idea as we can check in there for errors and missing details.

@csaunders
Copy link

Would it be possible to integrate Travis into this to provide some feedback on the mergability of the updates people are making.

A nice thing about using something like regular files / jekyll is they are easy peasy to understand and backups are simple.

I totally get the UX problem though. Would the app be a jekyll wrapper or would it simply be a web app?

@csaunders
Copy link

@andreionut could just glue into the github webhooks to make the server re-run jekyll whenever something is merged into master.

@hsbt
Copy link
Member

hsbt commented May 31, 2016

This pull request is no activity from Oct, 2014. Current master is huge differences from it time.

@hsbt hsbt closed this May 31, 2016
@hsbt hsbt deleted the issue-557-automate-index branch May 31, 2016 02:26
@mvz
Copy link
Author

mvz commented May 31, 2016

@hsbt Do you still consider #557 something that should be implemented?

@hsbt
Copy link
Member

hsbt commented May 31, 2016

No objection. But I oppose to migrate jekyll without providing instruction guide to non-programmers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants