search

maptime / maptime-admin

General maptime information (Start here!)
31 stars 6 forks source link

Migrate WP site to Jekyll/GH Pages #28

Closed geografa closed 9 years ago

geografa commented 10 years ago

I'd like to raise this as a long term goal. WP is easy, but it's a trap. If we want version control and more open-ness, I think serving GH pages would be a better way to go. Dealing with DBs, plugins, backups, version control, etc. is an unnecessary headache that's avoidable. If the barrier to entry is the issue (learning git), let's work on the issue rather than band-aid it with WP. Thumbs up?

mpmckenna8 commented 10 years ago

I second, as I said while they were setting up the WP stuff. I feel it will make it easier for anyone to contribute if we just use GH pages. But I guess I'll just keep adding to github pages stuff like I do for now.

jqtrde commented 10 years ago

:+1:

bethschechter commented 10 years ago

Hi, i hear the desire to put everything on Github /Jekyll. It has been an ongoing conversation.

I'm totally open to the idea, but chose Wordpress because it has the following functionality:

Since i don't know about Jekyll and Pages, i don't know what functionality it has. I have been told Jekyll does Markup and not WYSIWYG, which is fine, so long as we're not hand coding HTML.

No matter what, i need help with the web stuff and love the idea of a web team. If Jekyll / GH pages has all of the functionality above, and from this conversation emerges a team that wants to take on the migration, then that works for me.

//typed with thumbs On Apr 20, 2014 9:16 AM, "jacques" notifications@github.com wrote:

[image: :+1:]

— Reply to this email directly or view it on GitHubhttps://github.com/maptime/maptime/issues/28#issuecomment-40898305 .

geografa commented 10 years ago

@bethschechter I get your concerns. All the functionality is available with a Jekyll site with the exception of a WYSIWYG editor which I don't think folks will miss once they get a hang of Markdown. Plus, that would force users to standardize how they write posts. That said, I'm raising the question because I see value in dogfooding the site. To me, Maptime is about teaching, learning, and contributing back. WP is great but doesn't afford most to contribute back in the form of developing any sophistication to the site, unless we become php programmers with a desire to make WP plugins.

Maybe we can see what this looks like in the next couple of weeks so let's keep posting on WP. I can stub out the pages with MaptimePDX's pages then go from there. eh?

bethschechter commented 10 years ago

Hi all, I responded to this on Slack but worth repeating here: totally open to this idea and would like to make all of our lives easier. Is there a decent tutorial on markdown for peeps who are not up to speed on how to use it?

On Fri, Apr 25, 2014 at 6:56 PM, geografa notifications@github.com wrote:

@bethschechter https://github.com/bethschechter I get your concerns. All the functionality is available with a Jekyll site with the exception of a WYSIWYG editor which I don't think folks will miss once they get a hang of Markdown. Plus, that would force users to standardize how they write posts. That said, I'm raising the question because I see value in dogfooding http://en.wikipedia.org/wiki/Eating_your_own_dog_food the site. To me, Maptime is about teaching, learning, and contributing back. WP is great but doesn't afford most to contribute back in the form of developing any sophistication to the site, unless we become php programmers with a desire to make WP plugins.

Maybe we can see what this looks like in the next couple of weeks so let's keep posting on WP. I can stub out the pages with MaptimePDX's pages then go from there. eh?

— Reply to this email directly or view it on GitHubhttps://github.com/maptime/maptime/issues/28#issuecomment-41454251 .

Beth Schechter, Education + Outreach Stamen Design, LLC http://stamen.com/ +1 (415) 558-1610

bethschechter commented 10 years ago

So let's do this Jekyll thing. I'm hearing the desire to get more of the content all in one place, and have less logins for people, etc.

@geografa @camilleanne can the two of you coordinate getting this up and running? When do you think you can have it done by? Let me know what info I can give to you to help, e.g. URL or content hosting things.

clhenrick commented 10 years ago

@bethschechter re markdown tutorials; GitHub has some decent intros: see this one for basics and this cheatsheet. Also it's important to note that GitHub has it's own "flavor" of Markdown, not a big deal but some parts differ on here from traditional markdown. Explained here.

@almccon re Jekyll tutorials; this site has a free one that seems like a pretty good intro. We could certainly write our own.

I still think there is a valid concern that switching to Jekyll could be off-putting to some new comers when they realize they have to learn three new things (GitHub, Markdown, Jekyll) to be a part of Maptime. However I also think our role should always be to encourage people and help them learn these tools as well. That and another key element of getting into tech is having a willingness to be continually learning. I think these later points outweigh any potential aversion to joining Maptime due to fear of the unknown. Then again, maybe I'm wrong.

geografa commented 10 years ago

All right, sounds like consensus. Gonna move on this prob this upcoming weekend when I catch up on other things.

bethschechter commented 10 years ago

great! can you set up a dev site so we can see progress?

On Mon, Apr 28, 2014 at 12:53 PM, geografa notifications@github.com wrote:

All right, sounds like consensus. Gonna move on this prob this upcoming weekend when I catch up on other things.

— Reply to this email directly or view it on GitHubhttps://github.com/maptime/maptime/issues/28#issuecomment-41605054 .

Beth Schechter, Education + Outreach Stamen Design, LLC http://stamen.com/ +1 (415) 558-1610

geografa commented 10 years ago

absolutely. since maptime.github.io gets no traffic, we can just make that dev until we're ready to switch it over to maptime.io. I'll work in various branches but eventually push things into master and you should see changes when visiting http://maptime.github.io/

bethschechter commented 10 years ago

fabuloso. in the meantime, does it make sense for us to come up with a site map collectively? Or do you see that process unfolding organically?

On Mon, Apr 28, 2014 at 4:55 PM, geografa notifications@github.com wrote:

absolutely. since maptime.github.io gets no traffic, we can just make that dev until we're ready to switch it over to maptime.io. I'll work in various branches but eventually push things into master and you should see changes when visiting http://maptime.github.io/

— Reply to this email directly or view it on GitHubhttps://github.com/maptime/maptime/issues/28#issuecomment-41628584 .

Beth Schechter, Education + Outreach Stamen Design, LLC http://stamen.com/ +1 (415) 558-1610

almccon commented 10 years ago

So, @bethschechter and I gave Jekyll a try at the last #maptimesf, and we're worried that installing it locally will be too difficult for a lot of newbies. But we've been told that prose.io might be able to lower the barrier for new contributors. So, that's next on our todo list: evaluate prose.io.

almccon commented 10 years ago

So I played around a little bit with prose.io at last night's maptime. I can see that it is much easier for newbies to write blog posts, but it stills feels a little bit janky. For example, when I tried to drag and drop and image, it just sat there loading forever. When I finally loaded an image using the dialog box (instead of drag and drop) it didn't show up in my blog post. Is that something to do with the fact that the testing site is at maptime.github.io but the links assume it is at maptime.io? @geografa (and anyone else who is familiar with prose.io) can you test out prose on the jekyll site and see if it works as expected for you?

geografa commented 10 years ago

@almccon I've never had good luck with prose and I wasn't able to post an image successfully either. It just doesn't know where to put them. I would suggest making a working template anyone can use and host images externally, like on a group flickr account.

geografa commented 10 years ago

@almccon may also need to run this locally and set it up so it knows where your media folder is: https://github.com/prose/prose/wiki/Getting-Started

almccon commented 10 years ago

Okay, I'll try fussing with that next time. I was hoping prose would remove the need to work locally, which will be another hurdle for newbies. We'll see.

geobrando commented 10 years ago

I've noticed @geografa continues to work on a Jekyll site. Can I assume that a migration to a Jekyll site hosted at maptime.io is happening? Also, I remember some talk about local pages. Is the plan still to let chapters create/manage their own page as a a subpath (e.g. maptime.io/dc) using the starter repo or a custom Jekyll page? Ideally, I think chapters should be able to have one repo to use both as a regular repo (master branch) and to manage their page (gh-pages branch). I asked another question relating to this here:

geografa commented 10 years ago

@geobrando yes, migration is imminent. We need to:

This probably requires a little sprint but I think we're almost there. And yes, cloning the starter repo is a good way for other maptimes to make their own local page.

almccon commented 10 years ago

Woo this is getting even closer to happening! We did a little bit of the sprint today at WhereCampPDX. Making progress!

geografa commented 9 years ago

Done!