From 6f8e038f037d62432eb7053cbbae30de0ca0eb72 Mon Sep 17 00:00:00 2001 From: GreasyCat <131315c@gmail.com> Date: Fri, 3 Nov 2023 14:17:17 -0700 Subject: [PATCH] adding forking requriement to setup --- README.md | 27 ++++++++++++++++++++------- github_page/setup-local-env.md | 31 ++++++++++++++----------------- 2 files changed, 34 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 531440c..bce0b39 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,7 @@ Welcome to the documentation page for our GitHub repository! This repository con ## Accessing the Documentation Locally + To view and edit the documentation locally on your computer, you will need to set up a local development environment using Jekyll, which is a popular static site generator. Follow the steps below to get started: ### Prerequisites @@ -13,15 +14,25 @@ What you need - RubyGem - Bundler -1. Read the official installation guide [Jekyll official Installation Guide](https://jekyllrb.com/docs/installation/). It will guide your installation of Ruby and RubyGem step-by-step -- If **Bundler** is not installed: Install Bundler by running `gem install bundler` in your terminal. +### 1. Install Prerequisites + +Read the official installation guide [Jekyll official Installation Guide](https://jekyllrb.com/docs/installation/). It will guide your installation of Ruby and RubyGem step-by-step +- If **Bundler** is not installed after finishing the above guide: Install Bundler by running `gem install bundler` in your terminal. + -### Setting Up the Local Environment +### 2. Fork to Your Own Repo +Click on this [Link](https://github.com/ChrastilLab/chrastillab.github.io) and find the fork button as shown in the image below +- ![forking](/assets/images/github_page/adding-documentation/fork.png) -1. Clone this repository to your local machine using the following command: +### 3. Setting Up the Local Environment + +1. Clone **your own** repository to your local machine using the following command: + +{: .highlight} +remember to replace `YOUR_GITHUB_USERNAME` with your actual GitHub username ``` - git clone https://github.com/chrastillab/chrastillab.github.io + git clone https://github.com/YOUR_GITHUB_USERNAME/chrastillab.github.io ``` 2. Navigate to the repository's root directory: @@ -36,7 +47,7 @@ What you need bundle install ``` -### Viewing the Documentation +### 4. Viewing the Documentation 1. Once the dependencies are installed, you can start a local development server by running the following command: @@ -50,7 +61,9 @@ What you need You should see the documentation website running locally. -### Editing the Documentation +### Editing the Documentation + +Suggest reading: [How to add your own documentation](http://127.0.0.1:4000/github_page/markdown.html) 1. To make changes to the documentation, navigate to the appropriate Markdown files in the repository's directory structure. diff --git a/github_page/setup-local-env.md b/github_page/setup-local-env.md index 0ba0129..71683c1 100644 --- a/github_page/setup-local-env.md +++ b/github_page/setup-local-env.md @@ -4,9 +4,6 @@ title: 1. Set Up Local Environment nav_order: 1 parent: Write Your Own Documentation! --- -{: .note} -This is a copy-paste of the repo readme file [REAME](https://github.com/ChrastilLab/chrastillab.github.io) - ## Accessing the Documentation Locally @@ -19,17 +16,25 @@ What you need - RubyGem - Bundler -### Install Prerequisites +### 1. Install Prerequisites Read the official installation guide [Jekyll official Installation Guide](https://jekyllrb.com/docs/installation/). It will guide your installation of Ruby and RubyGem step-by-step - If **Bundler** is not installed after finishing the above guide: Install Bundler by running `gem install bundler` in your terminal. -### Setting Up the Local Environment -1. Clone this repository to your local machine using the following command: +### 2. Fork to Your Own Repo +Click on this [Link](https://github.com/ChrastilLab/chrastillab.github.io) and find the fork button as shown in the image below +- ![forking](/assets/images/github_page/adding-documentation/fork.png) + +### 3. Setting Up the Local Environment + +1. Clone **your own** repository to your local machine using the following command: + +{: .highlight} +remember to replace `YOUR_GITHUB_USERNAME` with your actual GitHub username ``` - git clone https://github.com/chrastillab/chrastillab.github.io + git clone https://github.com/YOUR_GITHUB_USERNAME/chrastillab.github.io ``` 2. Navigate to the repository's root directory: @@ -44,7 +49,7 @@ Read the official installation guide [Jekyll official Installation Guide](https: bundle install ``` -### Viewing the Documentation +### 4. Viewing the Documentation 1. Once the dependencies are installed, you can start a local development server by running the following command: @@ -58,12 +63,4 @@ Read the official installation guide [Jekyll official Installation Guide](https: You should see the documentation website running locally. -### Editing the Documentation - -1. To make changes to the documentation, navigate to the appropriate Markdown files in the repository's directory structure. - -2. Edit the Markdown files using your preferred text editor. - -3. Save your changes. - -4. Refresh the documentation website in your browser to see your edits. \ No newline at end of file +Now go to next section to see how to editing and uploading the page \ No newline at end of file