Skip to content

Commit

Permalink
adding forking requriement to setup
Browse files Browse the repository at this point in the history
  • Loading branch information
greasycat committed Nov 3, 2023
1 parent 090cae8 commit 6f8e038
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 24 deletions.
27 changes: 20 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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:
Expand All @@ -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:

Expand All @@ -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.

Expand Down
31 changes: 14 additions & 17 deletions github_page/setup-local-env.md
Original file line number Diff line number Diff line change
Expand Up @@ -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


Expand All @@ -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:
Expand All @@ -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:

Expand All @@ -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.
Now go to next section to see how to editing and uploading the page

0 comments on commit 6f8e038

Please sign in to comment.