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

Document how to make a blog post #429

Open
pikurasa opened this issue May 1, 2024 · 4 comments · May be fixed by #542
Open

Document how to make a blog post #429

pikurasa opened this issue May 1, 2024 · 4 comments · May be fixed by #542
Assignees

Comments

@pikurasa
Copy link
Contributor

pikurasa commented May 1, 2024

I've read through the README, but I'm still a bit confused.

Also, I see https://github.com/sugarlabs/www/tree/master/_posts but all of those are markdown files.

How does one make a new post?

On a related note, we have a medium account at https://medium.com/@sugarlabs/about -- does anyone here know who is in charge of that?

@quozl
Copy link
Contributor

quozl commented May 4, 2024

Posts are from 2008 to 2014, and are rendered at https://www.sugarlabs.org/press/

Posts were inherited from the site before student-led redesign projects in 2015, 2016 and 2017.

README as it stands now was mostly written by the 2017 project, after the posts, and doesn't describe how to maintain them.

Yes, the posts are in Markdown format, and the site generates HTML and PDF from them. That's an important feature; the posts are in a form that is maintainable via GitHub. However, since 2014 the posts have not been maintained, and no new posts made by developers or the oversight board members.

As far as I can tell from a quick look, one makes a new post by creating a file in the _posts directory, using the format of a previous post as guidance. Feel free to try that, and I'll merge.

I've no idea who created the Medium account. I made a quick search of all my mail and could find no announcement. The blog post is generic, has the style of student writing at the time, and came out just after Google Code-In and before Google Summer of Code. I suspect it was a performance demonstration.

@pikurasa
Copy link
Contributor Author

pikurasa commented May 5, 2024

@quozl Thank you for this response.

I was able to successfully create a new HTML post by creating a new .md file in _posts and Jeckyll automatically generated the HTML and PDF. In the coming days, I'll document the process.

Screenshot from 2024-05-04 21-23-55

As for Medium, I did just very recently get access to it.

Thank you so much!

@pikurasa pikurasa changed the title How do we make a blog post? Document how to make a blog post Oct 11, 2024
@pikurasa pikurasa self-assigned this Oct 11, 2024
@pikurasa
Copy link
Contributor Author

pikurasa commented Nov 7, 2024

@haroon10725 Perhaps you could add instructions to our README.md, since you implemented/improved the feature?

I can assist.

@haroon10725
Copy link
Contributor

Sure @pikurasa

@haroon10725 haroon10725 linked a pull request Nov 10, 2024 that will close this issue
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 a pull request may close this issue.

3 participants