diff --git a/.github/workflows/mkdocs.yaml b/.github/workflows/mkdocs.yaml new file mode 100644 index 0000000..133d233 --- /dev/null +++ b/.github/workflows/mkdocs.yaml @@ -0,0 +1,63 @@ +name: MK Docs + +on: + push: + branches: + - main + tags: + - "*" + - "Documentation-*" + pull_request_target: + +jobs: + build: + name: Build MkDocs + runs-on: ubuntu-latest + + steps: + - name: Checkout repo + uses: actions/checkout@v4 + + - name: Setup Python + uses: actions/setup-python@v5 + with: + python-version: '3.x' + + - name: Cache dependencies + uses: actions/cache@v4 + with: + path: ~/.cache/pip + key: ${{ runner.os }}-pip-${{ hashFiles('mkdocs/requirements.txt') }} + restore-keys: | + ${{ runner.os }}-pip- + + - name: Install dependencies + run: pip install -r mkdocs/requirements.txt + + - name: Build MK Docs project + run: mkdocs build -f mkdocs/mkdocs.yml + + - name: Upload MK Docs build files + uses: actions/upload-artifact@v4 + with: + name: mkdocs-files + path: ./mkdocs/site + + deploy: + name: Deploy to GitHub Pages + needs: build + runs-on: ubuntu-latest + if: startsWith(github.ref, 'refs/tags/v') || startsWith(github.ref, 'refs/tags/Documentation-') + + steps: + - name: Download MkDocs artifact + uses: actions/download-artifact@v4 + with: + name: mkdocs-files + path: ./mkdocs/site + + - name: Deploy to GitHub Pages + uses: peaceiris/actions-gh-pages@v3 + with: + github_token: ${{ secrets.GH_PAGES_TOKEN }} + publish_dir: ./mkdocs/site diff --git a/mkdocs/docs/aboutus.md b/mkdocs/docs/aboutus.md new file mode 100644 index 0000000..043d84e --- /dev/null +++ b/mkdocs/docs/aboutus.md @@ -0,0 +1,59 @@ +# CosmoXplore + +Welcome to CosmoXplore, your gateway to the marvels of the universe! We are dedicated to making space exploration accessible and captivating for everyone, from seasoned enthusiasts to curious minds. + +## 🌌 Our Vision + +At CosmoXplore, we have a bold vision of democratizing space exploration. Our mission is to inspire and educate individuals about the wonders of the cosmos while staying at the forefront of technological advancements in space science and exploration. + +## 🛰️ Our Project + +### Bringing Space Closer to You + +Our platform is designed to immerse you in the cosmos through stunning visuals and insightful content. We feature the Astronomy Picture of the Day (APOD) to showcase the beauty of the universe in a captivating way. Explore mesmerizing photos of Mars, get updates on NASA's latest missions, and delve into space-related news and discoveries. + +### NASA's Open API Integration + +CosmoXplore leverages NASA's open API to provide a seamless and interactive experience. Through this integration, we bring you real-time data, images, and information directly from NASA's extensive repository. Stay informed and engaged with the latest happenings in space exploration. + +### Community Collaboration + +As an open-source organization, collaboration is at the heart of CosmoXplore. We encourage contributions from passionate individuals, researchers, and space enthusiasts worldwide. Together, we strive to expand our knowledge, share discoveries, and foster a community of space exploration enthusiasts. + +## 🚀 Our Methods + +### Curated Content + +Our team curates high-quality content, including articles, news updates, and educational resources, to keep you informed and inspired about space exploration. + +### User-Friendly Interface + +CosmoXplore is designed with user experience in mind. Our intuitive interface makes it easy to navigate, discover new content, and engage with the cosmos. + +### Technological Advancements + +We embrace cutting-edge technologies to enhance your experience. From interactive features to immersive visuals, we aim to provide an engaging platform for space enthusiasts of all ages. + +## 👨🚀 Our Team + +### Founder: +- Pranav Barthwal + +### Contributors: +- Donald Reddy +- Chandu6702 +- Anjaliavv51 +- Pradeeptosarkar +- Surajvast1 +- Suhanipaliwal +- Shaurya35 +- RamakrushnaBiswal +- and many more... + +## 🌌 Join Our Cosmic Journey + +We are grateful for the dedication and contributions of our team members, each bringing unique skills and perspectives to CosmoXplore. + +Join us on this cosmic journey as we explore the wonders of the universe together. Whether you're a seasoned space enthusiast or just starting your journey of discovery, CosmoXplore welcomes you to dive into the mysteries and beauty of outer space. + +
diff --git a/mkdocs/docs/gettingstarted.md b/mkdocs/docs/gettingstarted.md new file mode 100644 index 0000000..38431fd --- /dev/null +++ b/mkdocs/docs/gettingstarted.md @@ -0,0 +1,59 @@ +# Getting Started with CosmoXplore + +## 🌠 Explore Our Tech Stack + +CosmoXplore is built using modern web technologies including HTML5, JavaScript, CSS3, and React. Our tech stack ensures a seamless and engaging experience for users as they delve into the wonders of space exploration. + + + + + + + +--- + +## 🚀 How to Contribute + +We welcome contributions from developers, designers, space enthusiasts, and anyone passionate about space exploration. Follow these steps to get started: + +- **Clone the Repository:** Clone the CosmoXplore repository to your local environment. + + ```bash + git clone https://github.com/