Skip to content

Commit

Permalink
Add final cleaning touches
Browse files Browse the repository at this point in the history
  • Loading branch information
thevahidal committed Dec 28, 2023
1 parent 1223d92 commit 92bcb86
Show file tree
Hide file tree
Showing 5 changed files with 20 additions and 12 deletions.
14 changes: 7 additions & 7 deletions .github/workflows/static.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,7 @@
# Simple workflow for deploying static content to GitHub Pages
name: Deploy static content to Pages
name: Deploy Jake Website to GitHub Pages

on:
# Runs on pushes targeting the default branch
# Runs on pushes targeting the main branch
push:
branches: ["main"]

Expand All @@ -22,7 +21,6 @@ concurrency:
cancel-in-progress: false

jobs:
# Single deploy job since we're just deploying
deploy:
environment:
name: github-pages
Expand All @@ -31,15 +29,17 @@ jobs:
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Install poetry
- name: Install Poetry
run: pipx install poetry
- uses: actions/setup-python@v5
with:
python-version: "3.11"
cache: "poetry"

- run: poetry install
- run: poetry run python script.py
- name: Install Dependencies
run: poetry install
- name: Run the Jake's Generator Script
run: poetry run python script.py
- name: Setup Pages
uses: actions/configure-pages@v4
- name: Upload artifact
Expand Down
11 changes: 10 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,14 @@ Jake is a tool that allows you to effortlessly create your own one-link website
## Usage

### Create a Repository

To get started, follow these steps to create a new repository using this template:

1. Click [here](https://github.com/new?template_name=jake&template_owner=thevahidal) to create a new repository.
2. Choose a name for your repository. If you want your website to be deployed at `<yourusername>.github.io`, name your repository `<yourusername>.github.io`. Alternatively, you can choose any other name, such as `that-other-name`, which will result in your website being deployed at `<yourusername>.github.io/that-other-name/`.

### Enable GitHub Pages

After creating the repository, you need to enable GitHub Pages. Follow these steps:

1. Go to your repository's `Settings` tab.
Expand All @@ -19,13 +21,15 @@ After creating the repository, you need to enable GitHub Pages. Follow these ste
4. Click `Save` to apply the changes.

### Add your data

To customize your website, follow these steps:

1. Open your repository in your preferred text editor.
2. Locate the `data.toml` file and update it with your own information.
3. Modify the following settings according to your preferences:

**General Information:**

- `name`: Your name (e.g., "Vahid Al")
- `description`: A brief bio about yourself (e.g., "Software Developer and passionate about creating things")
- `keywords`: Keywords for the keywords meta tag (e.g., "python, javascript, go")
Expand All @@ -37,31 +41,36 @@ To customize your website, follow these steps:
You can add multiple sections based on your requirements. For example, you may want a section for your projects, another for your social media links, and another for your merchandise products. Each section is defined using `[[sections]]`.

Each section has the following components:

- `title`: The title of the section (e.g., "Projects")
- `description`: A brief description of the section (e.g., "Here are some of my projects")
- `items`: The items associated with the section. Each item is defined using `[[sections.items]]`.

Each item within a section has the following components:

- `title`: The title of the item (e.g., "Soul")
- `description`: A brief description of the item (e.g., "An SQLite REST and Real-time server")
- `url`: The URL associated with the item (e.g., "https://github.com/thevahidal/soul")

Make the necessary modifications to the `data.toml` file based on the above instructions to customize your website with your own information and sections.

### Voila!

That's all you need to do. Now, you can sit back and relax while your website gets deployed. You can monitor the progress in the `Actions` tab of your repository. Once the deployment is complete, you can access your brand new one-link website at `<yourusername>.github.io` or `<yourusername>.github.io/repo-name/`.

> Note: You may need to manually trigger the GitHub Action to deploy your website. Here's how you can do it:
> 1. In your repository, navigate to the "Actions" tab located in the right sidebar.
> 2. Look for the workflow named "Deploy static content to Pages" in the list of workflows.
> 2. Look for the workflow named "Deploy Jake Website to GitHub Pages" in the list of workflows.
> 3. If you see an alert stating "This workflow has a workflow_dispatch event trigger," it means you can manually trigger the workflow.
> 4. Click on the "Run Workflow" button. A new window will appear.
> 5. Within the new window, click on the green "Run Workflow" button.
> 6. GitHub Actions will initiate the deployment process for your static content to GitHub Pages.
## Contributing

If you find any issues or have suggestions for improvement, please feel free to contribute by submitting a pull request or creating an issue in the repository.

## License

This project is licensed under the [MIT License](LICENSE).
Empty file removed github_actions_python/__init__.py
Empty file.
5 changes: 2 additions & 3 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
[tool.poetry]
name = "github-actions-python"
name = "jake"
version = "0.1.0"
description = ""
description = "Effortlessly create and deploy your own one-link website on GitHub."
authors = ["Vahid Al <[email protected]>"]
readme = "README.md"
packages = [{include = "github_actions_python"}]

[tool.poetry.dependencies]
python = "^3.11"
Expand Down
2 changes: 1 addition & 1 deletion script.py
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import tomllib

from tinyhtml import html, h, frag, raw
from tinyhtml import html, h, frag


with open("data.toml", "rb") as f:
Expand Down

0 comments on commit 92bcb86

Please sign in to comment.