[Docs] Add app logo to main page + cleanup (#7471)

* Add app logo to main page

* rename pages folder

* Add link + cleanup

* Cleanup file extension patterns

* Update Doxygen README.md

.github/workflows/documentation-build.yml

@@ -28,12 +28,13 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: "Checkout code"
+      - name: "Checkout"
         uses: actions/checkout@v7
         with:
           submodules: recursive
 
       - name: "Install Graphviz"
+        shell: bash
         run: |
           sudo apt-get install -y graphviz
           dot -V
@@ -44,6 +45,7 @@ jobs:
           version: "1.18.0"
 
       - name: "Update Doxygen Configuration"
+        shell: bash
         run: |
           git diff Doxyfile
           doxygen -u Doxyfile
@@ -58,9 +60,10 @@ jobs:
 
       - name: "Generate Documentation"
         if: always()
+        shell: bash
         run: doxygen Doxyfile
 
-      - name: "Deploy to cockatrice.github.io"
+      - name: "Deploy to cockatrice.github.io/docs"
         if: github.event_name == 'release' || github.event_name == 'workflow_dispatch'
         uses: peaceiris/actions-gh-pages@v4
         with:
@@ -69,3 +72,8 @@ jobs:
           external_repository: Cockatrice/cockatrice.github.io
           publish_branch: master
           publish_dir: ./docs/html
+
+      - name: Link to Documentation Page
+        if: github.event_name == 'release' || github.event_name == 'workflow_dispatch'
+        shell: bash
+        run: echo "::notice title=New documentation published::Shortly available at https://cockatrice.github.io/docs/"

Doxyfile

@@ -1066,25 +1066,11 @@ INPUT_FILE_ENCODING    =
 # provided as Doxygen C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08,
 # *.f18, *.f, *.for, *.vhd, *.vhdl, *.ucf, *.qsf and *.ice.
 
-FILE_PATTERNS          = *.cc \
-                         *.cxx \
-                         *.cxxm \
-                         *.cpp \
+FILE_PATTERNS          = *.cpp \
                          *.cppm \
-                         *.ccm \
-                         *.c++ \
-                         *.c++m \
-                         *.ii \
-                         *.ixx \
                          *.ipp \
-                         *.i++ \
                          *.inl \
                          *.h \
-                         *.hh \
-                         *.hxx \
-                         *.hpp \
-                         *.h++ \
-                         *.markdown \
                          *.md \
                          *.dox \
                          *.proto

doc/doxygen/README.md

@@ -1,13 +1,16 @@
 ## Building Doxygen Documentation
 
 We use [Doxygen](https://www.doxygen.nl) for our code documentation.  
-After installing the tool, you can build a HTML webpage into `/docs` folder according to our [configuration](https://github.com/Cockatrice/Cockatrice/blob/master/Doxyfile):
+After installing the tool, you can build a HTML webpage into the `/docs` folder according to our [configuration](https://github.com/Cockatrice/Cockatrice/blob/master/Doxyfile):
 ```bash
 doxygen Doxyfile
 ```
-Open the `index.html` file in the `/docs/html/` folder to view and use it.  
+Open the `index.html` file in the `/docs/html/` folder to browse the result locally.  
 There is also an online version we host at the Cockatrice webpage: [cockatrice.github.io/docs](https://cockatrice.github.io/docs)
 
+Doxygen's own documenation can be found at [www.doxygen.nl/manual](https://www.doxygen.nl/manual).
+
+<br>
 
 ## Doxygen Documentation Theme
 

doc/doxygen/pages/index.md

@@ -1,5 +1,9 @@
 @mainpage Documentation
 
+<div align="center">
+  <img src="cockatrice_logo.svg" style="width: 300px; max-width: 100%; height: auto;">
+</div>
+
 Welcome to the Cockatrice code documentation.
 
 - @subpage user_reference