SME Texaplex Virtual Chapter Website

This repository contains the source code for the official homepage of the SME Texaplex Virtual Chapter found at smetexaplex.com.

The mission of the SME Texaplex Virtual Chapter is to energize, mobilize and engage the Texas engineering and manufacturing community by leveraging the power and connectivity of the Internet.

We embrace the accessibility and connectivity of the Internet to launch immersive virtual events, unique learning experiences and always-on conversations. The SME Texaplex Virtual Chapter is completely volunteer-powered and a 501c3 nonprofit.

Read more about SME at sme.org.

Development Prerequisites

There are several prerequisites need to be installed on your development machine prior to working with this codebase.

Developers should use macOS or Linux to work with this codebase. Issues encountered using Windows are not considered bugs at this time.

1. Install Node.js version 10.0 or greater.

   See this page.

   For macOS development machines, installing Node.js with Homebrew is recommended.

2. Install Yarn.

   See this page.

3. Install Hugo.

   See this page.

   For macOS development machines, installing Hugo with Homebrew is recommended.

4. Install Git Large File Storage

   Git Large File Storage (or Git LFS) allows large binary assets like media source files to be managed by Git.

   See this page for installation instructions. If you are on macOS, installing via Homebrew is recommended.

Development Quick Start

For a freshly cloned repository, run:

yarn install

Once all of the above prerequisites are installed, the following commands are now available:

Command	Description
yarn run build:dev	Build project in development mode. Development mode artifacts that are generated are suitable for easier debugging.
yarn run build:prod	Build project in production mode.
yarn run clean	Delete the /docs folder which holds the generated artifacts from the build process.
yarn run serve:dev	Build project artifacts in development mode and run a development browser that will automatically refresh when source files are changed and saved.
yarn run serve:prod	Build project artifacts in production mode and launch a basic, local HTTP server without automatic reloading.

Hosting Environment

This project is set up to deploy to GitHub Pages. However, there is no reason that this project cannot be deployed to another hosting service of your choosing.

Community Participation Guidelines

The SME Texaplex Virtual Chapter is committed to providing a friendly, safe and welcoming environment for all. Please take a moment to read our Community Participation Guidelines.

Contributing

See the Contributing Guidelines document.

License

Most of the source code in this repository is available under the MIT License.

If a file or the contents of a directory are available under a different license, the license information will be indicted in the header of the file or inside of the directory.

SME Logos and Branding

While this project is permissively licensed, the SME logos and brands which are part of this codebase are not. SME logo and brand usage is only allowed by the SME and authorized parties connected to the SME (e.g. like regional chapters).

If you fork this project for use by your own website or web application, you must not use SME logos or brands inappropriately. Please see the SME Branding Guidelines for when a SME logo can be used and what conditions are attached to SME logos and brands.