diff --git a/documentation/assets/installation/tirith-version.png b/documentation/assets/installation/tirith-version.png new file mode 100644 index 0000000..9626b02 Binary files /dev/null and b/documentation/assets/installation/tirith-version.png differ diff --git a/documentation/docs/install-tirith-on-linux.md b/documentation/docs/install-tirith-on-linux.md deleted file mode 100644 index dbfdc76..0000000 --- a/documentation/docs/install-tirith-on-linux.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -id: install-tirith-on-linux -title: Install Tirith on linux -sidebar_label: Linux -description: This documentation overviews you about the introduction of the tirith software. -keywords: - - tirith - - stack-guardian -# url: https://www.lambdatest.com/support/docs/getting-started-with-tirith -site_name: Tirith -slug: install-tirith-on-linux/ ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - - \ No newline at end of file diff --git a/documentation/docs/install-tirith-on-mac.md b/documentation/docs/install-tirith-on-mac.md deleted file mode 100644 index 7e42553..0000000 --- a/documentation/docs/install-tirith-on-mac.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -id: install-tirith-on-mac -title: Install Tirith on macOS -sidebar_label: macOS -description: This documentation overviews you about the introduction of the tirith software. -keywords: - - tirith - - stack-guardian -# url: https://www.lambdatest.com/support/docs/getting-started-with-tirith -site_name: Tirith -slug: install-tirith-on-mac/ ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - - \ No newline at end of file diff --git a/documentation/docs/install-tirith-on-windows.md b/documentation/docs/install-tirith-on-windows.md deleted file mode 100644 index 5577a13..0000000 --- a/documentation/docs/install-tirith-on-windows.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -id: install-tirith-on-windows -title: Install Tirith on Windows -sidebar_label: Windows -description: This documentation overviews you about the introduction of the tirith software. -keywords: - - tirith - - stack-guardian -# url: https://www.lambdatest.com/support/docs/getting-started-with-tirith -site_name: Tirith -slug: install-tirith-on-windows/ ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - - \ No newline at end of file diff --git a/documentation/docs/tirith-installation/developer-mode-installation.md b/documentation/docs/tirith-installation/developer-mode-installation.md new file mode 100644 index 0000000..e638816 --- /dev/null +++ b/documentation/docs/tirith-installation/developer-mode-installation.md @@ -0,0 +1,61 @@ +--- +id: developer-mode-installation +title: Installation for Developers (Using Docker and Dev Containers in VS Code) +sidebar_label: Developer Mode Setup +description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system. +keywords: + - Tirith + - StackGuardian +# url: https://www.tirith.com/support/docs/getting-started-with-tirith +site_name: Tirith +slug: developer-mode-installation/ +--- + + +For developers who want to contribute to Tirith, setting up a [Dev Container in Visual Studio Code (VS Code)](https://code.visualstudio.com/docs/devcontainers/create-dev-container#_create-a-devcontainerjson-file) offers a robust development environment. This approach ensures that all dependencies and configurations are consistent across different setups. + +## Prerequisite +- Make sure your machine has [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) installed. +- Install [Git](https://git-scm.com/downloads) on your machine. +- Basic knowledge on [Docker](https://docs.docker.com/engine/install/) is required. + +## Steps to Install Tirith + +### Step 1: Clone the Repository +Clone the Tirith repository from GitHub to get the latest code: + +```bash +git clone https://github.com/StackGuardian/tirith.git +cd tirith +``` + +### Step 2: Set Up Docker +Ensure [Docker](https://docs.docker.com/engine/install/) is installed and running on your machine. You can manage Docker using Docker Desktop or the command-line interface (CLI). Docker allows you to run Tirith within isolated containers, preventing any dependency conflicts with your local system. + +### Step 3: Open the Project in VS Code +- Launch Visual Studio Code and open the cloned repository folder. +- Open the Command Palette by pressing `Ctrl+Shift+P` (or `Cmd+Shift+P` on macOS). +- Search for **Dev Containers: Rebuild and Reopen in Container** and select this option. +- VS Code will use the `devcontainer.json` configuration file within the project to build a containerized environment for Tirith. This configuration file contains settings for the development environment, such as necessary extensions and dependencies. Building the container may take a few minutes. +- Once the container is running, you’ll have a fully configured development environment within Docker, optimized for Tirith development. \ No newline at end of file diff --git a/documentation/docs/tirith-installation/manual-installation.md b/documentation/docs/tirith-installation/manual-installation.md new file mode 100644 index 0000000..9f023bd --- /dev/null +++ b/documentation/docs/tirith-installation/manual-installation.md @@ -0,0 +1,85 @@ +--- +id: manual-installation +title: Manual Installation (Using a Python Virtual Environment) +sidebar_label: Manual Setup +description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system. +keywords: + - Tirith + - StackGuardian +# url: https://www.tirith.com/support/docs/getting-started-with-tirith +site_name: Tirith +slug: manual-installation/ +--- + + +If you prefer a manual setup, especially if you want to modify Tirith’s codebase directly, follow these steps to install Tirith in a virtual Python environment. + +## Prerequisite +- Make sure your machine has [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) installed. +- Install [Git](https://git-scm.com/downloads) on your machine. + +## Steps to Install Tirith + +### Step 1: Clone the Repository +Clone the Tirith repository from GitHub to get the latest code: + +```bash +git clone https://github.com/StackGuardian/tirith.git +cd tirith +``` + +### Step 2: Set Up a Python Virtual Environment +Setting up a virtual environment isolates Tirith’s dependencies, preventing potential conflicts with other projects on your machine. + +Create a Virtual Environment: + +```bash +virtualenv .venv +``` + +Activate the Virtual Environment: + +```bash +source .venv/bin/activate +``` + +This command activates the virtual environment, ensuring all packages you install are contained within this environment. + +### Step 3: Install Tirith +With the virtual environment activated, install Tirith: + +```bash +pip install -e . +``` +The -e flag installs Tirith in `editable` mode, allowing you to make modifications to the codebase without needing to reinstall the package. + +### Step 4: Verify Installation +To confirm Tirith is installed and running properly, check its version: + +```bash +tirith --version +``` +You should see a version number output, verifying that Tirith is set up correctly. +
+tirith-version \ No newline at end of file diff --git a/documentation/docs/tirith-installation/quick-intallation.md b/documentation/docs/tirith-installation/quick-intallation.md new file mode 100644 index 0000000..25cec02 --- /dev/null +++ b/documentation/docs/tirith-installation/quick-intallation.md @@ -0,0 +1,58 @@ +--- +id: quick-installation +title: Quick Installation for Users +sidebar_label: Quick Setup +description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system. +keywords: + - Tirith + - StackGuardian +# url: https://www.tirith.com/support/docs/getting-started-with-tirith +site_name: Tirith +slug: quick-installation/ +--- + + +If you simply want to install and start using Tirith, this option provides a fast installation process with minimal setup. Perfect for end users and non-developers who only need basic functionality. + +## Prerequisite +- Make sure your machine has [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) installed. +- Install [Git](https://git-scm.com/downloads) on your machine. + +## Steps to Install Tirith + +### Step 1: Install using the `pip` command +Run the following command in your terminal to download Tirith directly from the GitHub repository and install it on your local system. This command ensures that you have the latest version. + +```bash +pip install git+https://github.com/StackGuardian/tirith.git +``` + + +### Step 2: Verify Installation +Once installed, verify that Tirith is working by checking its version. You should see a version number (e.g., 1.0.0-beta.12) indicating successful installation. +```bash +tirith --version +``` +
+tirith-version \ No newline at end of file diff --git a/documentation/docs/tirith-policy-conditions.md b/documentation/docs/tirith-policies/tirith-policy-conditions.md similarity index 100% rename from documentation/docs/tirith-policy-conditions.md rename to documentation/docs/tirith-policies/tirith-policy-conditions.md diff --git a/documentation/docs/tirith-policy-error-tolerance.md b/documentation/docs/tirith-policies/tirith-policy-error-tolerance.md similarity index 100% rename from documentation/docs/tirith-policy-error-tolerance.md rename to documentation/docs/tirith-policies/tirith-policy-error-tolerance.md diff --git a/documentation/docs/tirith-policy-examples.md b/documentation/docs/tirith-policies/tirith-policy-examples.md similarity index 100% rename from documentation/docs/tirith-policy-examples.md rename to documentation/docs/tirith-policies/tirith-policy-examples.md diff --git a/documentation/docs/tirith-policy-structure.md b/documentation/docs/tirith-policies/tirith-policy-structure.md similarity index 100% rename from documentation/docs/tirith-policy-structure.md rename to documentation/docs/tirith-policies/tirith-policy-structure.md diff --git a/documentation/docs/tirith-policy-variables.md b/documentation/docs/tirith-policies/tirith-policy-variables.md similarity index 100% rename from documentation/docs/tirith-policy-variables.md rename to documentation/docs/tirith-policies/tirith-policy-variables.md diff --git a/documentation/sidebars.js b/documentation/sidebars.js index cdb25df..0359a42 100644 --- a/documentation/sidebars.js +++ b/documentation/sidebars.js @@ -8,11 +8,12 @@ module.exports = { { type: "category", collapsed: true, - label: "Installation", + label: "Setup Tirith", + items: [ - "install-tirith-on-linux", - "install-tirith-on-windows", - "install-tirith-on-mac" + 'tirith-installation/quick-installation', + 'tirith-installation/developer-mode-installation', + 'tirith-installation/manual-installation' ] }, { @@ -20,11 +21,11 @@ module.exports = { collapsed: true, label: "Tirith Policies", items: [ - "tirith-policy-structure", - "tirith-policy-error-tolerance", - "tirith-policy-conditions", - "tirith-policy-variables", - "tirith-policy-examples" + "tirith-policies/tirith-policy-structure", + "tirith-policies/tirith-policy-error-tolerance", + "tirith-policies/tirith-policy-conditions", + "tirith-policies/tirith-policy-variables", + "tirith-policies/tirith-policy-examples" ] }, ],