Github - Revision history

Hunterirving: replace references to meetup with zeffy; document posts.json fields

2025-02-20T18:28:15Z

replace references to meetup with zeffy; document posts.json fields

← Older revision		Revision as of 14:28, 20 February 2025
Line 30:		Line 30:
	<pre>		<pre>
	{		{
	"title": "~~Tenth Annual Hacksburg Cider Making~~",		"title": "Woodworking 101",
	"subtitle": "~~Fresh, all-natural,~~ and ~~delicious!~~",		"subtitle": "Make sawdust (and a wooden box) in Hacksburg's woodshop",
	"description": "<p>~~Come~~ to ~~Hacksburg~~ with ~~apples~~ and ~~you'll be able~~ to ~~make your own cider! The best kind~~ of ~~apples to bring is~~ a ~~variety, only using one type typically results in extremely sweet or tart cider. Ten pounds of apples makes three quarts of cider. Free~~ to ~~anyone in the community, no RSVP required~~.</p><p>~~Want more information? We go into~~ the ~~cidermaking process in detail here: <~~a ~~href=\"https://hb.gy/0nAyF\" target=\"_blank\">https://hb.gy/0nAyF</a>~~.</p><p>~~Cider making is for attendees of all ages~~. ~~If you are bringing an attendee~~ under 18~~, you (the~~ parent/guardian~~) must stay the whole time your child/dependent is there~~.</p>",		"description": "<p>Attendees will have the opportunity to make a simple wooden box with handles and a lid. This project is designed to utilize almost all of the woodworking tools Hacksburg offers and provide a great introduction to woodworking.</p><p>To cover the cost of wood, this class will include a $30 materials fee.</p><p>Ages 16+. Attendees under 18 must be accompanied by a parent or guardian at all times.</p>",
	"date": "~~2024~~-10-20",		"date": "2025-02-16",
	"start_time": "1:00pm",		"start_time": "01:00pm",
	"end_time": "4:00pm",		"end_time": "04:00pm",
	"offsite_location": null,		"offsite_location": null,
	"offered_online": false,		"offered_online": false,
	"offered_in_person": true,		"offered_in_person": true,
	"member_price": 0,		"member_price": 0,
	"non_member_price": 0,		"non_member_price": 5,
	"image": "~~2018_cidermaking~~.jpg",		"materials_fee": 30,
	"~~meetup_link~~": "https://www.~~meetup~~.com/~~hacksburgva/events~~/~~302852557~~/",		"image": "wooden_box_2.jpg",
	"cancelled": false		"zeffy_link": "https://www.zeffy.com/en-US/ticketing/woodworking--101",
	}		"cancelled": false,
			"sold_out": false
			},
	</pre>		</pre>

	The build.py script uses these variables to build index.html automatically.		The build.py script uses these variables to build index.html automatically.
	Post images are stored in [https://github.com/Hacksburg/hacksburg.github.io/blob/master/resources/images /resources/images]. You can reference an existing image in your post, or add a new one.		Post images are stored in [https://github.com/Hacksburg/hacksburg.github.io/blob/master/resources/images /resources/images]. You can reference an existing image in your post, or add a new one.

	~~=== Building Posts Automatically from Meetup Data ===~~

	For your convenience, a [https://github.com/Hacksburg/hacksburg.github.io/blob/master/rss_to_json.ipynb Python notebook] is provided that scrapes [https://www.meetup.com/hacksburgva/ Hacksburg's Meetup page] to generate posts in the posts.json format. Note: For this script to work, you must be logged into Meetup. It is recommended that you preview your post(s) before creating a new pull request.

	=== Previewing Posts ===		=== Previewing Posts ===

Hunterirving at 16:37, 12 November 2024

2024-11-12T16:37:15Z

Show changes

John: Created page with "Hacksburg maintains a Github organization [https://github.com/Hacksburg here]. == Github == Board members should get push access to the Hacksburg repositories. For this, the..."

2020-05-24T17:29:45Z

Created page with "Hacksburg maintains a Github organization [https://github.com/Hacksburg here]. == Github == Board members should get push access to the Hacksburg repositories. For this, the..."

New page

Hacksburg maintains a Github organization [https://github.com/Hacksburg here].

== Github ==

Board members should get push access to the Hacksburg repositories. For this, they will need to make a Github account (if they don't have one already). Members pushing to repos should use Git or some UI equivalent (eg, TortoiseGit for Windows).

A full Git tutorial is beyond the scope of this document, but in general, here's how you do things with regular command-line Git (TortoiseGit and other GUI-based Git clients will be different!).

To work on a repository, you must first clone it by running

<file>
git clone [url]
</file>

where [url] is the URL of the repository. This will create a subdirectory with the contents of the repository in it.

=== Github Pages ===

The Hacksburg website lives at [http://hacksburg.org hacksburg.org]. It's hosted on Github's servers (thereby taking advantage of Github's good uptime). The repository is [https://github.com/hacksburg/hacksburg.github.io here].

==== Posting to the Site ====

The site is built using Jekyll, so to write a new post you will need to be added to the [https://github.com/hacksburg Hacksburg GitHub group]. Once you have access to that, clone the repository locally. Then, copy the format of one of the existing articles in the _posts/ directory, including the filename convention. Next, update the date and time of the filename to the current date and time, and change the title to something more meaningful (Ex: ''2015-06-02-1556-post_title.markdown'').

Change the data in the "frontmatter" (the section between the lines containing only dashes) to match your new post, and then write the remaining article in [https://guides.github.com/features/mastering-markdown/ Markdown syntax]. When you've done that, 'git add' the file you made, 'git commit' with a message about the article you wrote, and 'git push origin master' to get github to rebuild the page.

If you want to include images, put them in the images/ directory and reference them in the article as "/images/[filename]".

==== Blog style ====

The style of the blog uses Bootstrap to make it adaptive ('responsive'), and is based heavily on the example blog template provided on Bootstrap's home page. A number of changes have been made to this template. If you'd like to redesign or modify the design, it is probably a good idea to get acquainted with the Bootstrap documentation beforehand, as well as HTML and CSS, so you can make the changes in a sensible way.