davidl/laradock
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

minor docs improvements

Browse Source
This commit is contained in:
Mahmoud Zalt
2024-10-29 01:39:17 +01:00
parent 3ca9bb0a59
commit 480286abe5
16 changed files with 291 additions and 145 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.github/PULL_REQUEST_TEMPLATE.md vendored
View File

@@ -13,6 +13,6 @@
## Definition of Done Checklist:
<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
- [] I've read the [Contribution Guide](http://laradock.io/contributing).
- [] I've updated the **documentation**. (refer to [this](http://laradock.io/contributing/#update-the-documentation-site) for how to do so).
- [] I've read the [Contribution Guide](https://laradock.io/contributing).
- [] I've updated the **documentation**. (refer to [this](https://laradock.io/contributing/#update-the-documentation-site) for how to do so).
- [] I enjoyed my time contributing and making developer's life easier :)

BIN
.github/home-page-images/custom-sponsors/sista-ai-icon.png vendored
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 13 KiB

2
.github/workflows/build-deploy-docs.yml vendored
View File

@@ -28,7 +28,7 @@ jobs:
- name: Set up Node.js
uses: actions/setup-node@v3
with:
node-version: '16'
node-version: '18'
- name: Install DocuSource Dependencies
run: npm install

2
CONTRIBUTING.md
View File

@@ -1,3 +1,3 @@
# Thank you for your consideration
Checkout out our [contribution guide](http://laradock.io/contributing).
Checkout out our [contribution guide](https://laradock.io/contributing).

170
DOCUMENTATION/docs/Intro.md
View File

@@ -41,7 +41,9 @@ We offer a range of popular, pre-configured services that provide a ready-to-use
> To run a chosen container from the list below, run `docker-compose up -d {container-name}`.
> The container name `{container-name}` is the same as its folder name. Example to run the "PHP FPM" container, use the name "php-fpm".
| Category | Services |
| Category | Services (Containers) |
|---------------------------|--------------------------------------------------------------------------|
| **Web Servers** | NGINX, Apache2, Caddy |
| **Load Balancers** | HAProxy, Traefik |
@@ -69,6 +71,7 @@ We offer a range of popular, pre-configured services that provide a ready-to-use
| (**Laradock Workspace**) | PHP CLI, Composer, Git, Vim, xDebug, Linuxbrew, Node, V8JS, Gulp, SQLite, Laravel Envoy, Deployer, Yarn, SOAP, Drush, Wordpress CLI, dnsutils |
You can choose, which tools to install in your workspace container and other containers, from the `.env` file.
@@ -150,35 +153,35 @@ Laradock is an MIT-licensed open source project with its ongoing development mad
<tbody>
<tr>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/mahmoudz.png?s=150" />
<img width="115" height="115" src="https://github.com/mahmoudz.png?s=150" />
<br/>
<strong>Mahmoud Zalt</strong>
<br/>
<a href="https://github.com/Mahmoudz">@mahmoudz</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/appleboy.png?s=150" />
<img width="115" height="115" src="https://github.com/appleboy.png?s=150" />
<br/>
<strong>Bo-Yi Wu</strong>
<br/>
<a href="https://github.com/appleboy">@appleboy</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/philtrep.png?s=150" />
<img width="115" height="115" src="https://github.com/philtrep.png?s=150" />
<br/>
<strong>Philippe Trépanier</strong>
<br/>
<a href="https://github.com/philtrep">@philtrep</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/mikeerickson.png?s=150" />
<img width="115" height="115" src="https://github.com/mikeerickson.png?s=150" />
<br/>
<strong>Mike Erickson</strong>
<br/>
<a href="https://github.com/mikeerickson">@mikeerickson</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/zeroc0d3.png?s=150" />
<img width="115" height="115" src="https://github.com/zeroc0d3.png?s=150" />
<br/>
<strong>Dwi Fahni Denni</strong>
<br/>
@@ -187,35 +190,35 @@ Laradock is an MIT-licensed open source project with its ongoing development mad
</tr>
<tr>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/thorerik.png?s=150" />
<img width="115" height="115" src="https://github.com/thorerik.png?s=150" />
<br/>
<strong>Thor Erik</strong>
<br/>
<a href="https://github.com/thorerik">@thorerik</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/winfried-van-loon.png?s=150" />
<img width="115" height="115" src="https://github.com/winfried-van-loon.png?s=150" />
<br/>
<strong>Winfried van Loon</strong>
<br/>
<a href="https://github.com/winfried-van-loon">@winfried-van-loon</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/sixlive.png?s=150" />
<img width="115" height="115" src="https://github.com/sixlive.png?s=150" />
<br/>
<strong>TJ Miller</strong>
<br/>
<a href="https://github.com/sixlive">@sixlive</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/bestlong.png?s=150" />
<img width="115" height="115" src="https://github.com/bestlong.png?s=150" />
<br/>
<strong>Yu-Lung Shao (Allen)</strong>
<br/>
<a href="https://github.com/bestlong">@bestlong</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/urukalo.png?s=150" />
<img width="115" height="115" src="https://github.com/urukalo.png?s=150" />
<br/>
<strong>Milan Urukalo</strong>
<br/>
@@ -224,35 +227,35 @@ Laradock is an MIT-licensed open source project with its ongoing development mad
</tr>
<tr>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/vwchu.png?s=150" />
<img width="115" height="115" src="https://github.com/vwchu.png?s=150" />
<br/>
<strong>Vince Chu</strong>
<br/>
<a href="https://github.com/vwchu">@vwchu</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/zuohuadong.png?s=150" />
<img width="115" height="115" src="https://github.com/zuohuadong.png?s=150" />
<br/>
<strong>Huadong Zuo</strong>
<br/>
<a href="https://github.com/zuohuadong">@zuohuadong</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/lanphan.png?s=150" />
<img width="115" height="115" src="https://github.com/lanphan.png?s=150" />
<br/>
<strong>Lan Phan</strong>
<br/>
<a href="https://github.com/lanphan">@lanphan</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://github.com/ahkui.png?s=150" />
<img width="115" height="115" src="https://github.com/ahkui.png?s=150" />
<br/>
<strong>Ahkui</strong>
<br/>
<a href="https://github.com/ahkui">@ahkui</a>
</td>
<td align="center" valign="top">
<img width="125" height="125" src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/join-us.png" />
<img width="115" height="115" src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/join-us.png" />
<br/>
<strong>< Join Us ></strong>
<br/>
@@ -270,7 +273,7 @@ Laradock is an MIT-licensed open source project with its ongoing development mad
### Financial Contributors (Backers)
[![Open Collective backers](https://opencollective.com/laradock/tiers/awesome-backers.svg?width=800&avatarHeight=65&button=false&isActive=true)](https://opencollective.com/laradock#contributors)
[![Open Collective backers](https://opencollective.com/laradock/tiers/awesome-backers.svg?width=800&avatarHeight=55&button=false&isActive=true)](https://opencollective.com/laradock#contributors)
---
@@ -279,33 +282,125 @@ Laradock is an MIT-licensed open source project with its ongoing development mad
## Sponsors
Sponsoring is an act of giving in a different fashion. 🌱
<!-- Listing Contributors Refference: https://docs.opencollective.com/help/collectives/collective-settings/data-export#contributor-image -->
### Dimand Sponsors
<a href="https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=sponsor&utm_campaign=landing_page_content" target="_blank" style={{ marginRight: '4em' }}>
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/sista-ai-icon.png" height="165px" alt="Sista AI - Plug-and-Play AI Assistant. (www.sista.ai)" />
</a>
<a href="http://apiato.io/" target="_blank" style={{ marginRight: '4em' }}>
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/apiato.png" height="165px" alt="Apiato - Build PHP API's faster!" />
</a>
### Diamond Sponsors
<div style={{ display: 'flex', flexWrap: 'wrap', gap: '10px', justifyContent: 'left', alignItems: 'left' }}>
<a href="https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=sponsor&utm_campaign=landing_page_content" target="_blank">
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/sista-ai-icon.png" height="165px" alt="Sista AI - Plug-and-Play AI Assistant." />
</a>
<a href="http://apiato.io/" target="_blank" style={{ marginRight: '10px' }}>
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/apiato.png" height="135px" alt="Apiato - A powerful PHP framework for building scalable, enterprise-grade APIs!" />
</a>
</div>
### Gold Sponsors
<iframe
<!-- The embedded iframes sets rel="nofollow sponsored" on sponsor links by default,
which prevents SEO benefits from being passed to sponsor sites. to remove the nofollow for Gold sponors only, we'll be using custom links instead. -->
<!-- <iframe
src="https://opencollective.com/laradock/tiers/gold-sponsors.svg?avatarHeight=120&width=800&format=svg&button=false&background=#1B1B1D"
width="800"
height="200"
style={{ border: 'none', backgroundColor: '#1B1B1D' }}>
</iframe>
</iframe> -->
<div style={{ display: 'flex', flexWrap: 'wrap', gap: '10px', justifyContent: 'left', alignItems: 'left' }}>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/0/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/0/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/1/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/1/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/2/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/2/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/3/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/3/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/4/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/4/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/5/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/5/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/6/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/6/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/7/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/7/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/8/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/8/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/9/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/9/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/10/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/10/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/11/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/11/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/12/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/12/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/13/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/13/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/14/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/14/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/15/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/15/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/16/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/16/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/17/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/17/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/18/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/18/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/19/website" target="_blank" rel="sponsored">
<img src="https://opencollective.com/laradock/tiers/gold-sponsors/19/avatar.svg?button=false&isActive=true&avatarHeight=100" height="115" />
</a>
</div>
### Silver Sponsors
<iframe
src="https://opencollective.com/laradock/tiers/silver-sponsors.svg?avatarHeight=90&width=800&format=svg&button=false&background=#1B1B1D"
src="https://opencollective.com/laradock/tiers/silver-sponsors.svg?avatarHeight=90&width=800&format=svg&button=false&background=#1B1B1D&isActive=true"
width="800"
height="200"
style={{ border: 'none', backgroundColor: '#1B1B1D' }}>
@@ -314,25 +409,30 @@ Sponsoring is an act of giving in a different fashion. 🌱
### Bronze Sponsors
<iframe
src="https://opencollective.com/laradock/tiers/bronze-sponsors.svg?avatarHeight=65&width=800&format=svg&button=false&background=#1B1B1D"
src="https://opencollective.com/laradock/tiers/bronze-sponsors.svg?avatarHeight=55&width=800&format=svg&button=false&background=#1B1B1D&isActive=true"
width="800"
height="300"
style={{ border: 'none', backgroundColor: '#1B1B1D' }}>
</iframe>
### Supports Us
### Sponsorship Support
Sponsoring is an act of giving in a unique way. 🌱
You can support us using any of the methods below:
<b>1:</b> [Open Collective](https://opencollective.com/laradock) (For Sponsorships checkout Open Collective, or emails us at support@apiato.io)
<b>2:</b> [Github Sponsors](https://github.com/sponsors/Mahmoudz)
**1:** [Open Collective](https://opencollective.com/laradock)
*Available for all tiers:* Gold, Silver, Bronze, and Backers (Financial Contributors). **Preferred method.**
**2:** [Email](mailto:support@laradock.io)
*Available for Diamond sponsors only.*
**3:** [GitHub Sponsors](https://github.com/sponsors/Mahmoudz)
*Supports the creator of the project directly:* Ideal for personal support of the project creator.
## License
[MIT](https://github.com/laradock/laradock/blob/master/LICENSE) © Mahmoud Zalt
[MIT](https://github.com/laradock/laradock/blob/master/LICENSE) © [Mahmoud Zalt](https://zalt.me/)

35
DOCUMENTATION/docs/contributing.md
View File

@@ -35,37 +35,28 @@ You can request a new feature by submitting an [Issue](https://github.com/larado
## Update the Documentation (Site)
Laradock uses [Hugo](https://gohugo.io/) as website generator tool, with the [Material Docs theme](http://themes.gohugo.io/theme/material-docs/). You might need to check their docs quickly.
Laradock uses [Docusaurus](https://docusaurus.io/) as its documentation site generator.
Go the `DOCUMENTATION/content` and search for the markdown file you want to edit
Navigate to the `DOCUMENTATION/docs` directory to locate and edit the Markdown files for each section of the documentation.
Note: Every folder represents a section in the sidebar "Menu". And every page and sidebar has a `weight` number to show it's position in the site.
**Note:** Each folder under `docs` represents a section in the sidebar menu, with a `sidebar_position` field in the frontmatter of each file that determines its order.
To update the sidebar or add a new section to it, you can edit this `DOCUMENTATION/config.toml` toml file.
> The documentation site is auto-generated and deployed to the `gh-pages` branch by GitHub Actions when changes are pushed to the `master` branch.
> The site will be auto-generated in the `docs/` folder by [Travis CI](https://travis-ci.org/laradock/laradock/).
### Host the Documentation Locally
1. Make your changes are made in the `DOCUMENTATION/docs` directory (if you changed anything).
2. Navigate to `DOCUMENTATION/`.
3. Run the following command to start a local Docusaurus server:
```
npm run start
```
4. Visit [http://localhost:3000/](http://localhost:3000/) to view the documentation site locally.
This setup will allow you to preview your changes in real time.
### Host the documentation locally
**Option 1: Use Hugo Docker Image:**
1. Update the `DOCUMENTATION/content`.
2. Go to `DOCUMENTATION/`.
3. Run `docker run --rm -it -v $PWD:/src -p 1313:1313 -u hugo jguyomard/hugo-builder hugo server -w --bind=0.0.0.0`
4. Visit [http://localhost:1313/](http://localhost:1313/)
**Option 2: Install Hugo Locally:**
1. Install [Hugo](https://gohugo.io/) on your machine.
2. Update the `DOCUMENTATION/content`.
3. Delete the `/docs` folder from the root.
4. Go to `DOCUMENTATION/`.
5. Run the `hugo` command to generate the HTML docs inside a new `/docs` folder.
## Support new Software (Add new Container)

7
DOCUMENTATION/docs/getting-started.md
View File

@@ -1,7 +1,6 @@
---
sidebar_position: 2
title: Getting Started
---
## Requirements
@@ -38,7 +37,7 @@ git submodule add https://github.com/Laradock/laradock.git
Note: If you are not using Git yet for your project, you can use `git clone` instead of `git submodule `.
*To keep track of your Laradock changes, between your projects and also keep Laradock updated [check these docs](/documentation/#track-your-laradock-changes)*
*To keep track of your Laradock changes, between your projects and also keep Laradock updated [check these docs](/docs/usage#track-your-laradock-changes)*
2 - Make sure your folder structure should look like this:
@@ -148,7 +147,7 @@ If you use Chrome 63 or above for development, don't use `.dev`. [Why?](https://
If you are using **Docker Toolbox** (VM), do one of the following:
- Upgrade to [Docker Desktop](https://www.docker.com/products/docker-desktop/) for Mac/Windows (Recommended). Check out [Upgrading Laradock](/documentation/#upgrading-laradock)
- Upgrade to [Docker Desktop](https://www.docker.com/products/docker-desktop/) for Mac/Windows (Recommended). Check out [Upgrading Laradock](/docs/usage/#upgrading-laradock)
- Use Laradock v3.\*. Visit the [Laradock-ToolBox](https://github.com/laradock/laradock/tree/LaraDock-ToolBox) branch. *(outdated)*
<br/>
@@ -157,7 +156,7 @@ We recommend using a Docker Engine version which is newer than 19.03.0.
<br/>
>**Warning:** If you used an older version of Laradock it's highly recommended to rebuild the containers you need to use [see how you rebuild a container](/documentation/#Build-Re-build-Containers) in order to prevent as much errors as possible.
>**Warning:** If you used an older version of Laradock it's highly recommended to rebuild the containers you need to use [see how you rebuild a container](/docs/usage/#Build-Re-build-Containers) in order to prevent as much errors as possible.
<br/>

7
DOCUMENTATION/docs/usage.md
View File

@@ -2445,13 +2445,6 @@ Laradock provides aliases through the `aliases.sh` file located in the `laradock
3 - Rebuild and enjoy aliases
<br/>
<a name="phpstorm-debugging"></a>
## PHPStorm Debugging Guide
Remote debug Laravel web and phpunit tests.
[**Debugging Guide Here**](/guides/#PHPStorm-Debugging)
<br/>

13
DOCUMENTATION/docusaurus.config.ts
View File

@@ -5,7 +5,7 @@ import type * as Preset from '@docusaurus/preset-classic';
const config: Config = {
title: 'Laradock',
tagline: 'Full PHP development environment on Docker.',
favicon: 'img/porto-favicon.png',
favicon: 'laradock.ico',
// Set the production url of your site here
url: 'https://laradock.io/',
@@ -31,9 +31,10 @@ const config: Config = {
presets: [
[
'classic',
'@docusaurus/preset-classic',
{
docs: {
id: 'default',
sidebarPath: './sidebars.ts',
// Please change this to your repo.
// Remove this to remove the "edit this page" links.
@@ -50,17 +51,21 @@ const config: Config = {
theme: {
customCss: './src/css/custom.css',
},
gtag: {
trackingID: 'G-CVZBKZ36Y5', // Update with your Google Analytics ID
anonymizeIP: true,
},
} satisfies Preset.Options,
],
],
themeConfig: {
image: '/Porto/img/laradock/laradock-logo.jpg',
image: '/img/laradock/laradock-logo.jpg',
navbar: {
title: 'Laradock',
logo: {
alt: 'Laradock Logo',
src: '/Porto/img/laradock/laradock-icon.png',
src: '/img/laradock/laradock-icon.png',
},
items: [
// {

44
DOCUMENTATION/src/components/AiAssistant/index.tsx
View File

@@ -7,7 +7,7 @@ const AiAssistant = () => {
const history = useHistory();
const navigateToPage = ({ page }) => {
history.push(`/Porto/${page}`);
history.push(`/${page}`);
};
const navigateToExternalUrl = ({ url }) => {
@@ -56,41 +56,13 @@ const AiAssistant = () => {
description: "The page to navigate to.",
enum: [
"/?page=home",
"docs/Intro/?page=get_started",
"docs/intro/",
"docs/category/layers",
"docs/Layers/Layers Overview",
"docs/Layers/Containers Layer",
"docs/Layers/Ship Layer",
"docs/category/components",
"docs/Components/Components Overview",
"docs/category/main-components?page=main_components",
"docs/Components/Main Components Principles/Routes",
"docs/Components/Main Components Principles/Requests",
"docs/Components/Main Components Principles/Controllers",
"docs/Components/Main Components Principles/Actions",
"docs/Components/Main Components Principles/Tasks",
"docs/Components/Main Components Principles/Models",
"docs/Components/Main Components Principles/Views",
"docs/Components/Main Components Principles/Transformers",
"docs/Components/Main Components Principles/Exceptions",
"docs/Components/Main Components Principles/Sub-Actions",
"docs/Components/Optional Components",
"docs/Basics/Components Interaction",
"docs/Basics/Containers Dependencies",
"docs/Basics/Data Flow",
"docs/category/features",
"docs/Features/AI%20Driven Development",
"docs/Features/Monolithic to Microservices",
"docs/Quality Attributes",
"docs/Implementations",
"docs/Feedback",
"docs/Author",
"docs/Donations",
"docs/getting-started",
"docs/usage",
"docs/help",
"docs/related-projects",
"docs/contributing",
],
},
},
@@ -108,7 +80,7 @@ const AiAssistant = () => {
url: {
type: "string",
description:
"The URL to navigate to. For 'Github' go to 'https://github.com/Mahmoudz/Porto'. For 'Sista' go to 'https://smart.sista.ai/?utm_source=docs_porto&utm_medium=ai_assistant&utm_campaign=user_request_for_navigation'.",
"The URL to navigate to. For 'Github' go to 'https://github.com/laradock/laradock'. For 'Sista' go to 'https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=ai_assistant&utm_campaign=user_request_for_navigation'.",
},
},
required: ["url"],

2
DOCUMENTATION/src/components/SponsorsPage/index.tsx
View File

@@ -11,7 +11,7 @@ type SponsorItem = {
const SponsorList: SponsorItem[] = [
{
link: "https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=sponsor&utm_campaign=landing_page_welcome",
imageUrl: "/Porto/img/sponsors/sista-ai-logo.png",
imageUrl: "/img/sponsors/sista-ai-logo.png",
description: (
<>
<b>Make Your Apps Smarter with a Plug-and-Play AI Voice Assistant.</b>

4
DOCUMENTATION/src/pages/index.tsx
View File

@@ -2,17 +2,15 @@ import clsx from "clsx";
import Link from "@docusaurus/Link";
import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
import Layout from "@theme/Layout";
import HomepageFeatures from "@site/src/components/HomepageFeatures";
import Heading from "@theme/Heading";
import useBaseUrl from "@docusaurus/useBaseUrl";
import styles from "./index.module.css";
import VideoPage from "../components/VideoPage";
import WelcomePage from "../components/WelcomePage";
import SponsorsPage from "../components/SponsorsPage";
function HomepageHeader() {
const { siteConfig } = useDocusaurusContext();
const headerImage = useBaseUrl("/Porto/img/laradock/laradock-icon.png");
const headerImage = useBaseUrl("/img/laradock/laradock-icon.png");
return (
<header

BIN
DOCUMENTATION/static/img/sponsors/sista-ai-icon.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 9.2 KiB

BIN
DOCUMENTATION/static/laradock.ico Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.6 KiB

97
DOCUMENTATION/yarn.lock
View File

@@ -1812,6 +1812,88 @@
resolved "https://registry.yarnpkg.com/@polka/url/-/url-1.0.0-next.25.tgz#f077fdc0b5d0078d30893396ff4827a13f99e817"
integrity sha512-j7P6Rgr3mmtdkeDGTe0E/aYyWEWVtc5yFXtHCRHs28/jptDEWfaVOc5T7cblqy1XKPPfCxJc/8DwQ5YgLOZOVQ==
"@sentry-internal/browser-utils@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry-internal/browser-utils/-/browser-utils-8.35.0.tgz#92602f8dd2bb777af2994eb446cb3cf71bf0cfad"
integrity sha512-uj9nwERm7HIS13f/Q52hF/NUS5Al8Ma6jkgpfYGeppYvU0uSjPkwMogtqoJQNbOoZg973tV8qUScbcWY616wNA==
dependencies:
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry-internal/feedback@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry-internal/feedback/-/feedback-8.35.0.tgz#b31fb7fbec8ecd9cc683948a0d1af2b87731b0a1"
integrity sha512-7bjSaUhL0bDArozre6EiIhhdWdT/1AWNWBC1Wc5w1IxEi5xF7nvF/FfvjQYrONQzZAI3HRxc45J2qhLUzHBmoQ==
dependencies:
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry-internal/replay-canvas@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry-internal/replay-canvas/-/replay-canvas-8.35.0.tgz#de7849e0d4212ee37a9225b1fc346188d9b05072"
integrity sha512-TUrH6Piv19kvHIiRyIuapLdnuwxk/Un/l1WDCQfq7mK9p1Pac0FkQ7Uufjp6zY3lyhDDZQ8qvCS4ioCMibCwQg==
dependencies:
"@sentry-internal/replay" "8.35.0"
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry-internal/replay@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry-internal/replay/-/replay-8.35.0.tgz#f71abae95cb492a54b43885386adbc5c639486c7"
integrity sha512-3wkW03vXYMyWtTLxl9yrtkV+qxbnKFgfASdoGWhXzfLjycgT6o4/04eb3Gn71q9aXqRwH17ISVQbVswnRqMcmA==
dependencies:
"@sentry-internal/browser-utils" "8.35.0"
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry/browser@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry/browser/-/browser-8.35.0.tgz#67820951fd092ef72ee1a4897464bc7c8d317d77"
integrity sha512-WHfI+NoZzpCsmIvtr6ChOe7yWPLQyMchPnVhY3Z4UeC70bkYNdKcoj/4XZbX3m0D8+71JAsm0mJ9s9OC3Ue6MQ==
dependencies:
"@sentry-internal/browser-utils" "8.35.0"
"@sentry-internal/feedback" "8.35.0"
"@sentry-internal/replay" "8.35.0"
"@sentry-internal/replay-canvas" "8.35.0"
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry/core@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry/core/-/core-8.35.0.tgz#17090f4d2d3bb983d9d99ecd2d27f4e9e107e0b0"
integrity sha512-Ci0Nmtw5ETWLqQJGY4dyF+iWh7PWKy6k303fCEoEmqj2czDrKJCp7yHBNV0XYbo00prj2ZTbCr6I7albYiyONA==
dependencies:
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
"@sentry/react@^8.19.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry/react/-/react-8.35.0.tgz#059e9a02717ed0eb96919ea76a52f315a370b2ba"
integrity sha512-8Y+s4pE9hvT2TwSo5JS/Enw2cNFlwiLcJDNGCj/Hho+FePFYA59hbN06ouTHWARnO+swANHKZQj24Wp57p1/tg==
dependencies:
"@sentry/browser" "8.35.0"
"@sentry/core" "8.35.0"
"@sentry/types" "8.35.0"
"@sentry/utils" "8.35.0"
hoist-non-react-statics "^3.3.2"
"@sentry/types@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry/types/-/types-8.35.0.tgz#535c807800f7e378f61416f30177c0ef81b95012"
integrity sha512-AVEZjb16MlYPifiDDvJ19dPQyDn0jlrtC1PHs6ZKO+Rzyz+2EX2BRdszvanqArldexPoU1p5Bn2w81XZNXThBA==
"@sentry/utils@8.35.0":
version "8.35.0"
resolved "https://registry.yarnpkg.com/@sentry/utils/-/utils-8.35.0.tgz#1e099fcbc60040091c79f028a83226c145d588ee"
integrity sha512-MdMb6+uXjqND7qIPWhulubpSeHzia6HtxeJa8jYI09OCvIcmNGPydv/Gx/LZBwosfMHrLdTWcFH7Y7aCxrq7cg==
dependencies:
"@sentry/types" "8.35.0"
"@sideway/address@^4.1.5":
version "4.1.5"
resolved "https://registry.yarnpkg.com/@sideway/address/-/address-4.1.5.tgz#4bc149a0076623ced99ca8208ba780d65a99b9d5"
@@ -1845,10 +1927,11 @@
integrity sha512-TV7t8GKYaJWsn00tFDqBw8+Uqmr8A0fRU1tvTQhyZzGv0sJCGRQL3JGMI3ucuKo3XIZdUP+Lx7/gh2t3lewy7g==
"@sista/ai-assistant-react@^2.2.0":
version "2.2.32"
resolved "https://registry.yarnpkg.com/@sista/ai-assistant-react/-/ai-assistant-react-2.2.32.tgz#5e66e1f889c9707284ed0a33404c48214696b273"
integrity sha512-jm2BSHZD7KSbeO5cgsQxMO/Y/w9B3wwy8N5bNQlaeW+w7FFKsdvrLPLTiZBW0FiS6MrVpKzh5Yxcq/jZEN7waw==
version "2.2.40"
resolved "https://registry.yarnpkg.com/@sista/ai-assistant-react/-/ai-assistant-react-2.2.40.tgz#4f0829bca470790f56799cdf2ba1792c5d47128b"
integrity sha512-hEN8uR+Z9URoVEXpsm2Wu1iEurFCS2RKOOjJp99SIJBpks7ezc+UUha9vLoZqm79sS9CjOuxafZR2x1SuBvQnQ==
dependencies:
"@sentry/react" "^8.19.0"
howler "^2.2.4"
react-icons "^5.0.1"
uuid "^9.0.1"
@@ -4588,7 +4671,7 @@ history@^4.9.0:
tiny-warning "^1.0.0"
value-equal "^1.0.1"
hoist-non-react-statics@^3.1.0:
hoist-non-react-statics@^3.1.0, hoist-non-react-statics@^3.3.2:
version "3.3.2"
resolved "https://registry.yarnpkg.com/hoist-non-react-statics/-/hoist-non-react-statics-3.3.2.tgz#ece0acaf71d62c2969c2ec59feff42a4b1a85b45"
integrity sha512-/gGivxi8JPKWNm/W0jSmzcMPpfpPLc3dY/6GxhX2hQ9iGj3aDfklV4ET7NjKpSinLpJ5vafa9iiGIEZg10SfBw==
@@ -7043,9 +7126,9 @@ react-helmet-async@^1.3.0:
shallowequal "^1.1.0"
react-icons@^5.0.1:
version "5.2.1"
resolved "https://registry.yarnpkg.com/react-icons/-/react-icons-5.2.1.tgz#28c2040917b2a2eda639b0f797bff1888e018e4a"
integrity sha512-zdbW5GstTzXaVKvGSyTaBalt7HSfuK5ovrzlpyiWHAFXndXTdd/1hdDHI4xBM1Mn7YriT6aqESucFl9kEXzrdw==
version "5.3.0"
resolved "https://registry.yarnpkg.com/react-icons/-/react-icons-5.3.0.tgz#ccad07a30aebd40a89f8cfa7d82e466019203f1c"
integrity sha512-DnUk8aFbTyQPSkCfF8dbX6kQjXA9DktMeJqfjrg6cK9vwQVMxmcA3BfP4QoiztVmEHtwlTgLFsPuH2NskKT6eg==
react-is@^16.13.1, react-is@^16.6.0, react-is@^16.7.0:
version "16.13.1"

49
README.md
View File

@@ -3,7 +3,7 @@
</p>
<p align="center">
<a href="http://laradock.io/contributing"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="contributions welcome"></a>
<a href="https://laradock.io/contributing"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="contributions welcome"></a>
<a href="https://github.com/laradock/laradock/network"><img src="https://img.shields.io/github/forks/laradock/laradock.svg" alt="GitHub forks"></a>
<a href="https://github.com/laradock/laradock/issues"><img src="https://img.shields.io/github/issues/laradock/laradock.svg" alt="GitHub issues"></a>
<a href="https://github.com/laradock/laradock/stargazers"><a href="#backers" alt="sponsors on Open Collective"><img src="https://opencollective.com/laradock/backers/badge.svg" /></a> <a href="#sponsors" alt="Sponsors on Open Collective"><img src="https://opencollective.com/laradock/sponsors/badge.svg" /></a> <img src="https://img.shields.io/github/stars/laradock/laradock.svg" alt="GitHub stars"></a>
@@ -14,7 +14,7 @@
<p align="center"><b>Full PHP development environment based on Docker.</b></p>
<p align="center">
<a href="http://zalt.me"><img src="http://forthebadge.com/images/badges/built-by-developers.svg" alt="forthebadge" width="180"></a>
<a href="https://zalt.me"><img src="http://forthebadge.com/images/badges/built-by-developers.svg" alt="forthebadge" width="180"></a>
</p>
<br>
@@ -23,7 +23,7 @@
<h4 align="center" style="color:#7d58c2">Use Docker First - Learn About It Later!</h4>
<p align="center">
<a href="http://laradock.io">
<a href="https://laradock.io">
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/documentation-button.png" width="300px" alt="Laradock Documentation"/>
</a>
</p>
@@ -175,18 +175,34 @@ Sponsoring is an act of giving in a different fashion. 🌱
### Diamond Sponsors
<p align="left">
<a href="https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=sponsor&utm_campaign=github_readme_page" target="_blank">
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/sista-ai-icon.png" height="165px" alt="Sista AI - Plug-and-Play AI Assistant. (www.sista.ai)" style="margin-right: 4em;">
</a>
<a href="http://apiato.io/" target="_blank">
<img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/apiato.png" height="165px" alt="Apiato - Build PHP API's faster!">
</a>
<a href="https://smart.sista.ai/?utm_source=docs_laradock&utm_medium=sponsor&utm_campaign=github_readme_page" target="_blank"><img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/sista-ai-icon.png" height="165px" alt="Sista AI - Plug-and-Play AI Assistant." style="margin-right: 4em;"></a><a href="http://apiato.io/" target="_blank"><img src="https://raw.githubusercontent.com/laradock/laradock/master/.github/home-page-images/custom-sponsors/apiato.png" height="165px" alt="Apiato - A powerful PHP framework for building scalable, enterprise-grade APIs!"></a>
</p>
### Gold Sponsors
![Gold Sponsors](https://opencollective.com/laradock/tiers/gold-sponsors.svg?avatarHeight=120&width=800&format=svg&button=false&background=%231B1B1D)
<div style="display: flex; flex-wrap: wrap; gap: 25px; justify-content: left; align-items: left;">
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/0/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/0/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/1/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/1/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/2/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/2/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/3/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/3/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/4/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/4/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/5/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/5/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/6/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/6/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/7/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/7/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/8/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/8/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/9/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/9/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/10/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/10/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/11/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/11/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/12/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/12/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/13/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/13/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/14/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/14/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/15/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/15/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/16/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/16/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/17/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/17/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/18/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/18/avatar.svg?avatarHeight=100" height="115" /></a>
<a href="https://opencollective.com/laradock/tiers/gold-sponsors/19/website" target="_blank" rel="sponsored"><img src="https://opencollective.com/laradock/tiers/gold-sponsors/19/avatar.svg?avatarHeight=100" height="115" /></a>
</div>
### Silver Sponsors
@@ -197,21 +213,10 @@ Sponsoring is an act of giving in a different fashion. 🌱
![Bronze Sponsors](https://opencollective.com/laradock/tiers/bronze-sponsors.svg?avatarHeight=65&width=800&format=svg&button=false&background=%231B1B1D)
### Supports Us
You can sponsor us using any of the methods below:
<b>1:</b> Sponsor via [Open Collective](https://opencollective.com/laradock/).
<br>
<b>2:</b> Email us at <a href = "mailto: support@laradock.io">support@laradock.io</a>.
*Sponsors logos are displayed on the [github repository](https://github.com/laradock/laradock/) page and the [documentation website](http://laradock.io/) home page.*
## Translations
- [中文文档 (Chinese)](./README-zh.md)
## License
[MIT](https://github.com/laradock/laradock/blob/master/LICENSE) © Mahmoud Zalt
[MIT](https://github.com/laradock/laradock/blob/master/LICENSE) © [Mahmoud Zalt](https://zalt.me/)