To get started developing, you have two options. You can develop in a Docker Container using VS Code, or you can install Ruby locally and develop locally.
Do the following if you want to develop using Ruby on your local machine.
- Install Ruby 2.6 or higher (Linux, Mac, Windows)
- If you are on Windows, install DevKit
gem install bundler
Do this if you want to develop in a Docker container using VS Code.
-
Install and configure Docker for your operating system.
Windows / macOS:
- Install Docker Desktop for Windows/Mac.
- Right-click on the Docker taskbar item and update Settings / Preferences > Shared Drives / File Sharing with the drive the web app source code is located in. If you run into trouble, see Docker Desktop for Windows tips on avoiding common problems with sharing.
Linux:
- Follow the official install instructions for Docker CE/EE for your distribution.
- Add your user to the
docker
group by using a terminal to run:sudo usermod -aG docker $USER
- Sign out and back in again so your changes take effect.
-
Install Visual Studio Code.
-
Install the Remote Development extension pack.
-
Start VS Code and click on the quick actions Status Bar item in the lower left corner of the window.
-
Select Remote-Containers: Open Folder in Container... from the command list that appears, and open the root folder of the project you just cloned.
-
The window will then reload, but since the container does not exist yet, VS Code will create one. This may take some time, and a progress notification will provide status updates. Fortunately, this step isn't necessary the next time you open the folder since the container will already exist.
-
After the container is built, VS Code automatically connects to it and maps the project folder from your local file system into the container.
-
Open the terminal in VS Code to a bash prompt within the container by clicking on Terminal > New Terminal
-
In the terminal, type
bundle exec jekyll serve
to build and run the web site. (See below) -
Open the web site at http://localhost:4000.
-
Begin developing in Visual Studio Code.
GitHub will do this automatically when you push, but this allows you to view the site locally before you commit.
bundle install
bundle exec jekyll serve
- Clone this repository
- Add a new file to
_posts
in the formyyyy-mm-dd-title-of-event.md
where the date is the date of the event and the title is as it should appear. Dashes will be converted to spaces. - Copy the content from another event file and edit as appropriate.
- Make sure you update the URL to the link to the new Meetup event. The hash at the end changes each month.
- Test your changes locally, then commit and push to GitHub.
- GitHub will automatically compile the changes and the event will appear.
The following is an example of an event file in Markdown format.
---
layout: event
time: 6:30pm to 9:00pm
location: The Pheasant Plucker @ 20 Augusta Street
register: https://www.meetup.com/CoderCamp-Hamilton/events/stdttmyzqbpb/
---
AJ Bovaird will tell us a little bit about the new features coming in ASP.net vNext.
[Rob Prouse](http://www.alteridem.net) will demonstrate creating applications for [Android Wear](https://github.com/Codercamp/AndroidWear) by prototyping an application that lists the pubs closest to you, allows you to view their menus and order on your watch.
Matt Grande is going to come tell us more about the HSR Real Time Data Hackathon on July 26th.
Bryan will also providing a brief update on the Coderetreat Evening being planned for July 23rd.