added support for upload actions (#64)

* added support for upload actions
* doc refactoring

Author: julienj

composer.json

@@ -14,7 +14,8 @@
         "symfony/http-client": "^7.0",
         "symfony/property-access": "^7.0",
         "phpseclib/phpseclib": "^3.0",
-        "phpdocumentor/reflection-docblock": "^5.3"
+        "phpdocumentor/reflection-docblock": "^5.3",
+        "symfony/finder": "^7.0"
     },
     "require-dev": {
         "phpunit/phpunit": "^11.0",

composer.lock

@@ -41,4 +41,5 @@
 "scss/05_components/components.menu",
 "scss/05_components/components.main",
 "scss/05_components/components.footer",
-"scss/05_components/components.404";
+"scss/05_components/components.404",
+"scss/05_components/components.doc";

doc/assets/app.scss

@@ -61,7 +61,7 @@ address {
 ol, ul, dl {
   list-style-type: none;
   margin: 0;
-  padding: 0;
+  padding: 0 0 0 2rem;
 }
 
 ol ol, ul ul, ol ul, ul ol {

doc/assets/scss/02_generics/_generics.reset.scss

@@ -63,31 +63,9 @@ li {
 
 pre,
 code {
-  font-size: 1.5rem;
-  line-height: 2.2rem;
+  font-size: 1.4rem;
   border: 1px solid #e8e8e8;
   border-radius: 3px;
-  background-color: #eef;
-}
-
-pre {
-  margin-bottom: 1.6rem;
-
-  code {
-    border: 0;
-    padding: 0.8rem 1.2rem;
-    overflow-x: auto;
-    display: block;
-    color: var(--color-code);
-
-    &.language-bash {
-      background-color: var(--color-code-bg-bash);
-    }
-
-    &.language-yaml {
-      background-color: var(--color-code-bg-yaml);
-    }
-  }
 }
 
 

doc/assets/scss/03_elements/_elements.page.scss

@@ -0,0 +1,5 @@
+.c-doc {
+  a {
+    text-decoration: underline !important;
+  }
+}

doc/assets/scss/05_components/_components.doc.scss

@@ -14,7 +14,13 @@
                 <script src="{{ asset('typewriter.js') }}"></script>
             {% else %}
                 <script src="{{ asset('page.js') }}"></script>
-            {% endif %}
+
+                <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/atom-one-dark.min.css">
+                <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+                <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/bash.min.js"></script>
+                <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/yaml.min.js"></script>
+                <script>hljs.highlightAll();</script>
+                {% endif %}
 
             {%- include 'partials/metatags.html.twig' with {page, site} only ~%}
 

doc/layouts/_base.html.twig

@@ -5,5 +5,7 @@
 {% endblock %}
 
 {% block content %}
-    {{ page.content }}
+    <div class="c-doc">
+        {{ page.content }}
+    </div>
 {% endblock %}

doc/layouts/page.html.twig

@@ -0,0 +1,62 @@
+---
+title: "Deployment strategies"
+menu:
+  main:
+    weight: 30
+---
+
+# Deployment strategies Automate
+
+Automate offers three deployment options, each tailored to specific needs:
+
+### 1. Git Deployment
+
+In this approach, you specify a repository in Automate's configuration.
+Automate then clones this repository and uses commands to prepare the application directly on the remote server.
+This method is the simplest to implement.
+
+example : 
+
+~~~~yaml
+repository: git@github.com:symfony/symfony-demo.git
+on_deploy:
+    - composer install
+    - yarn install
+    - yarn build
+post_deploy:
+    - cmd: "php bin/console doctrine:migrations:migrate"
+      only: [ dev-example-front-01]
+~~~~
+
+### 2. Continuous Integration (CI) + Automate
+
+Utilize your continuous integration (CI) tools to perform build steps in your CI environment.
+Then, Automate is used to push files directly to the server without using Git. 
+This approach allows executing commands on the server at the end of the process, such as updating your database.
+
+example :
+
+~~~~yaml
+# do not specify a repository
+pre_deploy:
+    - upload: .
+      exclude: [node_modules]
+post_deploy:
+    - cmd: "php bin/console doctrine:migrations:migrate"
+      only: [ dev-example-front-01]
+~~~~
+
+### 3. Mixed Deployment
+
+In this setup, you use Git to download your sources and then send only specific files or folders from your CI. 
+For example, you might only send the build of your assets. This approach combines the simplicity of Git with the flexibility of custom deployment.
+~~~~yaml
+repository: git@github.com:symfony/symfony-demo.git
+pre_deploy:
+    - upload: public/build
+post_deploy:
+    - cmd: "php bin/console doctrine:migrations:migrate"
+      only: [ dev-example-front-01]
+~~~~
+
+