From be3306aac2b667a36f15fc96c306deefa059589a Mon Sep 17 00:00:00 2001 From: Dibyashanu Pati <> Date: Wed, 5 Jun 2024 14:35:26 +0530 Subject: [PATCH] Added preliminary instruction to access the repo --- README.md | 46 +++++++++++++++++++++++++++++++++++++++++++++- main.org | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 97 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 9c8e73d..d62adcb 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,47 @@ # cosmicpirates.space +This is the source code of the cosmicpirates.space website -the cosmicpirates website \ No newline at end of file +## Quickstart +Currently in the cosmicpirates.space source can ge accessed on our private [Gitea](https://about.gitea.com/) server. + +### Step 1 : SSH into the cosmicpirates server with forward tunnel of port 3000 to your local port 3000 +ssh into the server and forward the port on which Gitea is running(in our case port 3000) into our local port 3000 + +```console +ssh -L 3000:localhost:3000 pirate@cosmicpirates.space +``` +### Step 2: Open Gitea on your Browser +Open http://localhost:3000/ in your browser +Create an account if nessasary(Not required if you just want to view but required if you want to push to a repo). +You should be able to see this project repository at http://localhost:3000/dibyashanu/cosmicpirates.space + +### Step 3: Clone the repo +Make a local copy of this repo +```console +git clone http://localhost:3000/dibyashanu/cosmicpirates.space.git +``` + +Go to the repo directory +```console +cd cosmicpirates.space. +``` + +Set a username and email - this will be used to track the changes you make to this repository +```console +git config user.name "Your Name Here" +git config user.email "your@email.com" +``` + +Set the origin to the required location + +```console +git remote add origin http://localhost:3000/dibyashanu/cosmicpirates.space.git +``` +### Step 4: Make changes to the local version of the repository +Most of the time try only to make changes to the [main.org](./main.org) and generate all other content by either running scripts in this file or runing org-babel-tangle(C-c C-v t in doom emacs). +For more details see [main.org](./main.org) + +### Step 5: Push Your changes to this repository +```console +$ git push -u origin main +``` diff --git a/main.org b/main.org index 5486b37..9316492 100644 --- a/main.org +++ b/main.org @@ -21,6 +21,56 @@ Writing dynamic content to files and then using #+include to include them in oth * Static content and Sample code snippets +** Generating the README.md file +#+begin_src md :tangle README.md +# cosmicpirates.space +This is the source code of the cosmicpirates.space website + +## Quickstart +Currently in the cosmicpirates.space source can ge accessed on our private [Gitea](https://about.gitea.com/) server. + +### Step 1 : SSH into the cosmicpirates server with forward tunnel of port 3000 to your local port 3000 +ssh into the server and forward the port on which Gitea is running(in our case port 3000) into our local port 3000 + +```console +ssh -L 3000:localhost:3000 pirate@cosmicpirates.space +``` +### Step 2: Open Gitea on your Browser +Open http://localhost:3000/ in your browser +Create an account if nessasary(Not required if you just want to view but required if you want to push to a repo). +You should be able to see this project repository at http://localhost:3000/dibyashanu/cosmicpirates.space + +### Step 3: Clone the repo +Make a local copy of this repo +```console +git clone http://localhost:3000/dibyashanu/cosmicpirates.space.git +``` + +Go to the repo directory +```console +cd cosmicpirates.space. +``` + +Set a username and email - this will be used to track the changes you make to this repository +```console +git config user.name "Your Name Here" +git config user.email "your@email.com" +``` + +Set the origin to the required location + +```console +git remote add origin http://localhost:3000/dibyashanu/cosmicpirates.space.git +``` +### Step 4: Make changes to the local version of the repository +Most of the time try only to make changes to the [main.org](./main.org) and generate all other content by either running scripts in this file or runing org-babel-tangle(C-c C-v t in doom emacs). +For more details see [main.org](./main.org) + +### Step 5: Push Your changes to this repository +```console +$ git push -u origin main +``` +#+end_src ** Generating the ASCII headings *** Main Heading #+name: main-heading-text @@ -702,5 +752,5 @@ for root,dir,filename in os.walk(directory): -* TODO Things to do -** TODO Setup Gitea to host the source code (org files) of the website +* Things to do +** DONE Setup Gitea to host the source code (org files) of the website