-
Notifications
You must be signed in to change notification settings - Fork 35
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: elitechef <[email protected]>
- Loading branch information
Showing
1 changed file
with
142 additions
and
18 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,28 +1,152 @@ | ||
| # JODC Website | ||
| This is the main website for JODC built with Svelte and Sapper | ||
| <div align=center> | ||
|
|
||
| <p> | ||
| <img src="https://res.cloudinary.com/dcykxiua2/image/upload/v1601403909/screely-1601393893331_vglbvb.png"> | ||
| </p> | ||
|
|
||
| [](https://github.com/JIITODC/jiitodc.github.io/issues) [](https://github.com/JIITODC/jiitodc.github.io/network/members) [](https://github.com/JIITODC/jiitodc.github.io/stargazers)   | ||
|
|
||
| </div> | ||
|
|
||
| ## :ledger: Index | ||
|
|
||
| ## How to contribute | ||
| - [About](#beginner-about) | ||
| - [Features](#page_facing_up-features) | ||
| - [Usage](#zap-usage) | ||
| - [File Structure](#file_folder-file-structure) | ||
| - [Static](#static) | ||
| - [Production mode and deployment](#production-mode-and-deployment) | ||
| - [Contributions](#fire-contributions) | ||
| - [Gallery](#camera-gallery) | ||
| - [Credit/Acknowledgment](#star2-creditacknowledgment) | ||
| - [License](#lock-license) | ||
|
|
||
| We welcome contributions from everyone. Here are the guidelines if you are | ||
| thinking of helping us: | ||
| ## :beginner: About | ||
|
|
||
| Contributions should be made in the form of GitHub pull requests. | ||
| Each pull request will be reviewed by someone with permission to land patches and either landed in the main tree or | ||
| given feedback for changes that would be required. All contributions should | ||
| follow this format. | ||
| This is the main website for JODC built with Svelte and Sapper | ||
|
|
||
| ## :page_facing_up: Features | ||
|
|
||
| Should you wish to work on an issue, please claim it first by commenting on | ||
| the GitHub issue that you want to work on it. This is to prevent duplicated | ||
| efforts from contributors on the same issue. | ||
| - Completely responsive Web Application. | ||
| - Built completely in Svelte+Sapper. | ||
| - Open for opensource contributions. | ||
|
|
||
| Look for [good first issues](https://github.com/JIITODC/jiitodc.github.io/labels/good%20first%20issue) to find | ||
| good tasks to start with. | ||
| ## :zap: Usage | ||
|
|
||
| ## Setup instructions | ||
| - However you get the code, you can install dependencies and run the project in development mode with: | ||
|
|
||
| ```sh | ||
| $ git clone https://github.com/JIITODC/jiitodc.github.io | ||
| ```bash | ||
| $ cd jiitodc.github.io | ||
| $ npm install | ||
| $ npm install # or yarn | ||
| $ npm run dev | ||
| ``` | ||
|
|
||
| - Open up localhost:3000 and start clicking around. | ||
| - Consult sapper.svelte.dev for help getting started. | ||
|
|
||
| ## :file_folder: File Structure | ||
|
|
||
| - Add a file structure here with the basic details about files, below is current file structure. | ||
|
|
||
| ``` | ||
| . | ||
| ├── package-lock.json | ||
| ├── package.json | ||
| ├── README.md | ||
| ├── rollup.config.js | ||
| ├── src | ||
| │ ├── client.js | ||
| │ ├── components | ||
| │ │ ├── EventComponent.svelte | ||
| │ │ ├── Nav.svelte | ||
| │ │ ├── TeamComponent.svelte | ||
| │ │ └── TeamComponent_Old.svelte | ||
| │ ├── routes | ||
| │ │ ├── _error.svelte | ||
| │ │ ├── _layout.svelte | ||
| │ │ ├── events.svelte | ||
| │ │ ├── index.svelte | ||
| │ │ └── team | ||
| │ │ ├── index.svelte | ||
| │ │ ├── team-2018.svelte | ||
| │ │ └── team-2019.svelte | ||
| │ ├── server.js | ||
| │ ├── service-worker.js | ||
| │ └── template.html | ||
| ├── static | ||
| │ ├── Data/ | ||
| │ ├── favicon.svg | ||
| │ ├── global.css | ||
| │ ├── manifest.json | ||
| │ ├── Photos/ | ||
| │ └── posters/ | ||
| └── vercel.json | ||
| ``` | ||
|
|
||
| - Sapper expects to find two directories in the root of your project — `src` and `static`. | ||
|
|
||
| | No | File Name | Details | | ||
| | --- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | 1. | [src](src) | The src directory contains the entry points for your app — `client.js`, `server.js` and (optionally) a `service-worker.js` — along with a `template.html` file and a routes directory. | | ||
| | 2. | [src/routes](src/routes) | This is the heart of your Sapper app. There are two kinds of routes — pages, and server routes. | | ||
| | 3. | Pages | Pages are Svelte components written in .svelte files. When a user first visits the application, they will be served a server-rendered version of the route in question, plus some JavaScript that 'hydrates' the page and initialises a client-side router. From that point forward, navigating to other pages is handled entirely on the client for a fast, app-like feel. (Sapper will preload and cache the code for these subsequent pages, so that navigation is instantaneous.) | | ||
| | 3. | Server Routes | Server routes are modules written in `.js` files, that export functions corresponding to HTTP methods. Each function receives Express request and response objects as arguments, plus a next function. This is useful for creating a `JSON` API | | ||
|
|
||
| ##### For example:- | ||
|
|
||
| There are three simple rules for naming the files that define your routes: | ||
|
|
||
| - A file called `src/routes/about.svelte` corresponds to the `/about` route. A file called `src/routes/blog/[slug].svelte` corresponds to the `/blog/:slug` route, in which case params.slug is available to the route | ||
| - The file src/routes/index.svelte (or src/routes/index.js) corresponds to the root of your app. `src/routes/about/index.svelte` is treated the same as `src/routes/about.svelte`. | ||
| - Files and directories with a leading underscore do not create routes. This allows you to colocate helper modules and components with the routes that depend on them — for example you could have a file called `src/routes/\_helpers/datetime.js` and it would not create a `/\_helpers/datetime route` | ||
|
|
||
| ## Static | ||
|
|
||
| The static directory contains any static assets that should be available. These are served using `sirv`. | ||
|
|
||
| In your service-worker.js file, you can import these as files from the generated manifest... | ||
| `import { files } from '@sapper/service-worker';` | ||
|
|
||
| ...so that you can cache them (though you can choose not to, for example if you do not want to cache very large files). | ||
|
|
||
| ## Production mode and deployment | ||
|
|
||
| To start a production version of your app, run npm run build && npm start. This will disable live reloading, and activate the appropriate bundler plugins. | ||
|
|
||
| ## :fire: Contributions | ||
|
|
||
| We welcome contributions from everyone. Here are the guidelines if you are thinking of helping us: | ||
|
|
||
| Contributions should be made in the form of GitHub pull requests. Each pull request will be reviewed by someone with permission to land patches and either landed in the main tree or given feedback for changes that would be required. All contributions should follow this format. | ||
|
|
||
| Should you wish to work on an issue, please claim it first by commenting on the GitHub issue that you want to work on it. This is to prevent duplicated efforts from contributors on the same issue. | ||
|
|
||
| Look for good first issues to find good tasks to start with. | ||
| Your contributions are always welcome and appreciated. Following are the things you can do to contribute to this project. | ||
|
|
||
| 1. **Report a bug** <br> | ||
| If you think you have encountered a new issue, and we should know about it, feel free to report it and we will take care of it. | ||
|
|
||
| 2. **Create a pull request** <br> | ||
| It cannot get better then this, your pull request will be appreciated by the community. You can get started by picking up any open issues and make a pull request. | ||
|
|
||
| > If you are new to open-source, make sure to check read more about it [here](https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source) and learn more about creating a pull request [here](https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github). | ||
| ## :camera: Gallery | ||
|
|
||
| <p align="center"> | ||
| <img src="https://res.cloudinary.com/dcykxiua2/image/upload/v1601403909/shotsnapp-1601403666.419_p57vxt.png" width="800"> | ||
| </p> | ||
| <p align="center">The main landing Page.</p> | ||
|
|
||
| <p align="center"> | ||
| <img src="https://res.cloudinary.com/dcykxiua2/image/upload/v1601404144/shotsnapp-1601404124.596_qpkdu5.png" width="800"> | ||
| </p> | ||
| <p align="center">The Events Page.</p> | ||
|
|
||
| ## :lock: License | ||
|
|
||
| [](https://github.com/JIITODC/jiitodc.github.io/blob/master/LICENSE) | ||
|
|
||
| ## :star2: Credit/Acknowledgment | ||
| [](https://github.com/JIITODC/jiitodc.github.io/graphs/contributors) |
d6df087There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Successfully deployed to the following URLs: