diff --git a/.github/workflows/md-html-deploy.yml b/.github/workflows/md-html-deploy.yml new file mode 100644 index 0000000..05fb2bd --- /dev/null +++ b/.github/workflows/md-html-deploy.yml @@ -0,0 +1,37 @@ +name: Convert Markdown to HTML and Deploy + +on: + push: + branches: + - main # Trigger the workflow on push to the main branch + +jobs: + build-and-deploy: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + + - name: Set up Node.js + uses: actions/setup-node@v2 + with: + node-version: '14' + + - name: Install dependencies + run: npm install + + - name: Convert Markdown to HTML + run: | + mkdir -p _site + for file in *.md; do + pandoc "$file" -o "_site/${file%.md}.html" + done + + - name: Deploy to GitHub Pages + run: | + git config --global user.name 'github-actions[bot]' + git config --global user.email 'github-actions[bot]@users.noreply.github.com' + git add _site + git commit -m 'Deploy static HTML files' + git push origin main diff --git a/GitHub/demos/0_GithubAImodels.md b/GitHub/demos/0_GithubAImodels.md index 32e17d9..9f18a1c 100644 --- a/GitHub/demos/0_GithubAImodels.md +++ b/GitHub/demos/0_GithubAImodels.md @@ -4,7 +4,7 @@ Costa Rica [![GitHub](https://img.shields.io/badge/--181717?logo=github&logoColor=ffffff)](https://github.com/) [brown9804](https://github.com/brown9804) -Last updated: 2024-12-13 +Last updated: 2025-01-13 ---------------------- @@ -188,7 +188,6 @@ Last updated: 2024-12-13 | **Integrate Responses** | - Use the responses from the AI model in your application.
- For example, display the generated text in a web app or use it to automate a task. | | **Optimize and Iterate**| - Continuously optimize your prompts and code based on the responses.
- Iterate to improve the performance and relevance of the AI model. | - ### Transition to Production | **Step** | **Description** | @@ -198,3 +197,7 @@ Last updated: 2024-12-13 | **Monitor and Scale** | Monitor your usage and scale your application as needed using Azure’s infrastructure | +
+

Total Visitors

+ Visitor Count +
diff --git a/GitHub/demos/1_GitHubPagesOverview.md b/GitHub/demos/1_GitHubPagesOverview.md new file mode 100644 index 0000000..f418416 --- /dev/null +++ b/GitHub/demos/1_GitHubPagesOverview.md @@ -0,0 +1,118 @@ +# GitHub Pages -Overview + +Costa Rica + +[![GitHub](https://img.shields.io/badge/--181717?logo=github&logoColor=ffffff)](https://github.com/) [brown9804](https://github.com/brown9804) + +Last updated: 2025-01-13 + +---------------------- + +> **GitHub Pages** is a feature provided by GitHub that allows you to `host static websites directly from a GitHub repository`. It's a great way to showcase your projects, create personal websites, or host documentation for your repositories. + +## Wiki + +
+Table of Wiki (Click to expand) + +- [Websites for you and your projects](https://pages.github.com/) +- [Essentials of automated application deployment with GitHub Actions and GitHub Pages](https://resources.github.com/learn/pathways/automation/essentials/automated-application-deployment-with-github-actions-and-pages/) + +
+ +## Content + +
+Table of Content (Click to expand) + +- [Wiki](#wiki) +- [Content](#content) +- [How is GitHub Pages Used?](#how-is-github-pages-used) +- [Automate the process of converting Markdown to static HTML and deploying it using GitHub Pages and GitHub Actions](#automate-the-process-of-converting-markdown-to-static-html-and-deploying-it-using-github-pages-and-github-actions) +- [Setting Up GitHub Pages](#setting-up-github-pages) + +
+ +> What is GitHub Pages?
+> GitHub Pages is a `free service that turns your GitHub repositories into websites`. You can host HTML, CSS, and JavaScript files, and it’s perfect for static websites that `don’t require server-side processing`. GitHub Pages supports custom domains, making it easy to create a professional-looking website. + +## How is GitHub Pages Used? +- **Personal Websites**: Showcase your portfolio, resume, or blog. +- **Project Documentation**: Host documentation for your open-source projects. +- **Organization Sites**: Create websites for organizations or communities. +- **Demo Sites**: Share live demos of your projects. + +## Automate the process of converting Markdown to static HTML and deploying it using GitHub Pages and GitHub Actions + +1. Create a GitHub Repository + - Go to GitHub and create a new repository. Name it `username.github.io`, where `username` is your GitHub username. + - Make sure the repository is public. +2. Add Your Markdown Files + - Clone the repository to your local machine. + - Add your Markdown files to the repository. + - Commit and push the changes to GitHub. +3. Create a GitHub Actions Workflow + - In your repository, create a `.github/workflows` directory. + - Inside this directory, create a file named `md-html-deploy.yml`. +4. Define the Workflow: Add the following content to the `md-html-deploy.yml` file to set up a workflow that converts Markdown to HTML and deploys it to the `main` branch: + 1. **Checkout Repository**: This step checks out your repository so that the workflow can access the files. + 2. **Set up Node.js**: This step sets up Node.js, which is required for some Markdown converters. + 3. **Install Dependencies**: This step installs the necessary dependencies for your project. + 4. **Convert Markdown to HTML**: This step uses `pandoc` to convert Markdown files to HTML and places them in the `_site` directory. + 5. **Deploy to GitHub Pages**: This step commits the generated HTML files back to the `main` branch and pushes the changes. This ensures that your GitHub Pages site is updated with the latest HTML files. + + ```yaml + name: Convert Markdown to HTML and Deploy + + on: + push: + branches: + - main # Trigger the workflow on push to the main branch + + jobs: + build-and-deploy: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + + - name: Set up Node.js + uses: actions/setup-node@v2 + with: + node-version: '14' + + - name: Install dependencies + run: npm install + + - name: Convert Markdown to HTML + run: | + mkdir -p _site + for file in *.md; do + pandoc "$file" -o "_site/${file%.md}.html" + done + + - name: Deploy to GitHub Pages + run: | + git config --global user.name 'github-actions[bot]' + git config --global user.email 'github-actions[bot]@users.noreply.github.com' + git add _site + git commit -m 'Deploy static HTML files' + git push origin main + ``` + +## Setting Up GitHub Pages +1. **Create a Repository**: Create a new repository on GitHub or use an existing one. +2. **Enable GitHub Pages**: + - Go to the repository settings on GitHub. + - Under the `GitHub Pages` section, select the `GitHub Actions`, and `Static HTML` as the source. + + image + + > Static HTML refers to web pages that are delivered to the user's browser exactly as stored, without any server-side processing. Static sites are fast, secure, and easy to deploy, making them ideal for simple websites, portfolios, blogs, and documentation. +3. Push Your Code: Commit and push your code to the main branch. The GitHub Actions workflow will automatically run and deploy your site to GitHub Pages. + +
+

Total Visitors

+ Visitor Count +