search

RefugeRestrooms / refugerestrooms

REFUGE restrooms indexes and maps safe restroom locations for trans, intersex, and gender nonconforming individuals.
http://www.refugerestrooms.org
GNU Affero General Public License v3.0
891 stars 263 forks source link

Add Blog #639

Open mpeiffer opened 3 years ago

mpeiffer commented 3 years ago

Context

Summary of Changes

Checklist

Screenshots

landing_page test_blog_post

DeeDeeG commented 3 years ago

Hi, thanks for this. Will take a closer look when I get the chance, but just wanted to let you know I've seen this.

The screenshots look pretty reasonable! And at first look, so does all the code and such.

I'll ping some of the other maintainers and see if they have any thoughts about blog posts. I suppose I could post some things myself from the perspective of maintaining the project and what's been up lately around this repository. I wonder what people would be most interested in? (Or what, amongst ourselves, the maintainers would most want to put out there?)

But this has been on the to-do list for a while, so I'm glad to see an implementation that can be put to use pretty much immediately if/when we want to post something.

Best regards, - DeeDeeG

mpeiffer commented 3 years ago

Glad to help! Please let me know if there's anything that needs editing when you get the chance to look over it.

mi-wood commented 3 years ago

Hi @mpeiffer , thanks for the PR! It would be great to have a blog again.

Is there any way to host this from the main app instead of github.io? It would be nice to serve it from refugerestrooms.org/blog rather than another domain/site. I'm not up to date with rails blog knowledge, but I imagine there's a way to serve it there as a route.

mpeiffer commented 3 years ago

Hi @mi-wood! I think that would be possible. You would need to go to the repository settings, and the under the github pages settings, enter refugerestrooms.org/blog as the domain name instead of the default domain name.

DeeDeeG commented 3 years ago

Thanks for the updates. I plan to "approve" this pull request, or mark it as "hacktoberfest-accepted", because it has genuinely helped with considering the GitHub Pages option for the blog in a concrete way. (That would make this pull request count toward the Hacktoberfest number of pull requests, if you're participating in that event.) I would plan to do that since this pull request has been genuinely helpful, but there would be some difficulty merging it here. (And because some additional discussion with the other maintainers would be good before activating this).

Some notes:

I've been trying to get this code up and running in a "test" sort of way. (Here: https://github.com/DeeDeeG/test_refugerestrooms_blog/ --> https://deedeeg.github.io/test_refugerestrooms_blog/)

As far as I can tell, GitHub only lets you activate a GitHub Pages site from the main (root) folder, or the docs subfolder.

GitHub Pages settings view, focusing a "select folder" dropdown that shows only the "/ (root)" and "/docs" options available.

The root folder should be neat and tidy for this repository (for the main web app) in my opinion, and the docs/ subfolder doesn't really fit for a blog, so I think if we use GitHub Pages, we will do so in a separate repository from this one (RefugeRestrooms/refugerestrooms).

I've looked into changing the theme and all that. And I've reviewed how to make a new blog post, from the documentation you linked to. Seems doable.

Thanks for this!

P.S.: in order to make this pull request into a separate repository, I cloned your fork to my local computer, then separated out the blog subfolder of this pull request's branch into its own, separate branch, following these instructions: https://stackoverflow.com/questions/359424/detach-move-subdirectory-into-separate-git-repository/17864475#17864475. Then I pushed that to my DeeDeeG/test_refugerestrooms_blog/ repository here on GitHub, then activated GitHub Pages in the settings of that repository.

P.P.S. if you prefer your code not be hosted that way in the test repository I made, please do let me know and I can delete that repository, or if you prefer the code hosted at the main RefugeRestrooms organization, I can do that. I don't want to move people's code around in ways that are unexpected, so I have absolutely no problem moving or deleting that test repo in whatever way you would request.

mpeiffer commented 3 years ago

I think that it makes sense to put it into it's own repository, so I don't mind where you host the code. Thank you for adding the Hacktoberfest label!