233 Commits

Author SHA1 Message Date
Claudio Zizza
2c890bd383 Use addCommand to replace add-method of Console Application 2026-01-14 00:35:50 +01:00
Claudio Zizza
cde5e824c5 Convert xml config files to php
Symfony XmlFileLoader is deprecated and will be removed
2025-12-06 00:24:34 +01:00
Claudio Zizza
40e77f6005 Refactor project-version handling into its own class 2025-12-04 23:38:57 +01:00
Claudio Zizza
182c5736e8 Filter out versions that are not supposed to be in the docs 2025-12-04 22:47:20 +01:00
Claudio Zizza
0c9f634b3a Add rst code highlighting 2025-11-26 23:01:59 +01:00
Grégoire Paris
0c4d609fe8 Improve phpdoc types 2025-10-18 14:09:03 +02:00
Grégoire Paris
d94ac8e925 Avoid pass by reference
The method is already returning a result, and it's unused. This will
make it easier to document parameters.
2025-10-18 10:40:48 +02:00
Claudio Zizza
3ae5e119c0 Remove flag on yaml parsing
This fixes phpstan issues in #831
2025-10-15 23:47:07 +02:00
Grégoire Paris
33dd4ee532 Throw clear error message on misconfiguration
This issue can occur when a project versions has no branch name and no
tags.
2025-10-15 07:56:30 +02:00
Christophe Coevoet
495b4ac8f4 Inline the static website generator in the website repo
Maintaining a standalone static website generator project that is not
reused outside our website adds maintenance overhead. For instance,
support for using `phpdocumentor/guides` was implemented in the website
repo rather than the standalone generator package, which was still using
the `doctrine/rst-parser` package that we want to abandon.
2025-10-09 21:46:37 +02:00
Claudio Zizza
d4a62599c8 Remove Doctrine 1 from website 2025-10-09 13:57:05 +02:00
Claudio Zizza
841e43ab28 Prevent using --libversion without --project
It does't make sense to use libversion without project
2025-10-08 10:52:32 +02:00
Claudio Zizza
04d4a65624 Skip not cloned project repos on build 2025-10-08 10:49:18 +02:00
Claudio Zizza
ebaec09065 Allow single project build in build-all command 2025-10-07 16:33:46 +02:00
Grégoire Paris
b4d57bd7d6 Add null check
When that variable is null, there is no point in executing the code
below, because there is not going to be a branch called ".x".
2025-10-02 08:30:13 +02:00
Claudio Zizza
199b762b14 Bump phpstan/phpstan to 2.1.28 and fix issues (#805)
* Update phpstan to latest 2.11 version

* Fix phpstan narrowed type issue
2025-09-24 11:24:37 +02:00
Jaapio
ec00efbcc4 Added extra tests 2025-07-05 23:48:53 +02:00
Jaapio
156dacd5c2 Remove old unused code rendering 2025-07-05 23:48:53 +02:00
Jaapio
4bc58773c7 In order to resolve cross site scripting remove php rendering
The current implementation of the code block is using unsafe html
by replacing it with a twig template we resolve this issue.
2025-07-05 23:48:53 +02:00
Claudio Zizza
3570624fea Fix order of arguments for saveObjects 2025-04-25 00:05:50 +02:00
Claudio Zizza
2bb3d70e32 Introduce additional sort order for projects 2025-04-16 00:05:43 +02:00
Claudio Zizza
01221066db Adapt code to new coding-standard version 2025-03-25 00:50:23 +01:00
Jaapio
1eee5aa28f Use guides to parse and render markdown 2025-03-24 20:05:46 +01:00
Grégoire Paris
5e98897d27 Upgrade the Algolia SDK to v4
The main difference is the disappearance of the SearchIndex interface.
Instead, the client's method now all have a new argument for specifying
the index name to act on.
2025-02-05 07:56:36 +01:00
Claudio Zizza
6756e79bf1 Remove code path usage from projects 2025-01-24 00:38:13 +01:00
Jaapio
794f07092f Remove unneeded autofixes
- `:depth` and `:maxdepth` are both supported by guides
- term text role was never used in all docs
- `code::` is an alias of `code-block`
2024-10-22 22:17:52 +02:00
Grégoire Paris
d60535b2ad fix: copy more than just rst files
Now that we use literalinclude, source files include more than just rst
files. I'd say anything with an extension goes.

Files that are not rst files should be copied verbatim.

This addresses an issue with guides not finding files referenced in
literalinclude directives, because they were never copied.
2024-10-16 22:47:45 +02:00
Claudio Zizza
b8149dc6c0 Fix phpstan error that appear with bleedingEdge 2024-10-16 19:54:55 +02:00
Jaapio
8e2b34feb0 Fix static page links
Static pages do not have an source to find references, so static
html links are used. Guides does see them as invalid links. This new
resolver allows us to accept the static links as valid and uses the targetreference
as url.
2024-10-16 07:02:16 +02:00
Jaapio
6908eec5b1 Improve menu generation
So the origin of the menu's not working is in the way the menu's are defined. The doctrine parser did use * as a deep search wildcard which is not according to the behavior sphinx does it. As the toctree is a directive defined by sphinx we try to follow that one closely. The correct way of writing a toctree is

```
.. toctree::
   :glob:

   **
```

This will include all documents and sections in a project. starting at the level of the current page.
2024-09-25 23:03:08 +02:00
Jaapio
679159992d Replace logger with monolog
The logger introduced before was very usefull in the setup process
but by now, it should be replaced by something more mature to ensure
the logs to not end up in the final output.
2024-09-25 21:03:40 +02:00
Claudio Zizza
43a97a60b9 Merge pull request #615 from jaapio/fix/default-menu
Full wildcard match on default menu
2024-09-25 20:13:04 +02:00
Jaapio
f56c22f3fc Full wildcard match on default menu
We do want to include every document in the menu when we do a fallback
to the default menu. `/*` does match all files are root level, while we
wanted to match everything `*`.
2024-09-24 23:46:48 +02:00
Jaapio
45fc3fa255 Fix section author markup
Apply the correct template for section authors.
Add an extra fix in the migration from old doc styles to correct the
display of author names.
2024-09-24 22:17:38 +02:00
Jaapio
ea15e4dbb7 Do only move document level menu nodes 2024-09-24 00:36:53 +02:00
Jaapio
1315f593ab Move theme configuration to compilerpass
To allow full usage of the configuration move the theme configuration
to a compiler pass that will set the value.
2024-09-20 21:18:41 +02:00
Jaapio
6ef0be66c2 Improve menu handling
As toctree does modify the structure of the docs, which results
in infinitif loops when items refer to eachother, we switched
to menu.
2024-09-20 21:01:28 +02:00
Jaapio
46391cc8dd Cleanup copier code 2024-09-20 20:39:00 +02:00
Jaapio
670b052175 Improve test assert 2024-09-20 20:35:10 +02:00
Jaapio
750eef0701 Add phpstan types for arrays 2024-09-20 20:26:55 +02:00
Jaapio
4ff3848fbb Fix issue with tables in doctrine1 docs 2024-09-18 23:15:49 +02:00
Jaapio
d5a3cc643a Use guides to build search index 2024-09-17 23:14:47 +02:00
Jaapio
971020a87a Fix doc style 2024-08-23 17:10:34 +02:00
Jaapio
792e73c923 Add new static website generator
Use guides to render rst pages.
2024-08-21 23:06:38 +02:00
Jaapio
456878eded Remove all rst parser related code 2024-08-21 22:50:11 +02:00
Jaapio
017d252b5d Remove guides-code as it is not used right now. 2024-08-21 22:49:45 +02:00
Jaapio
d544ef5822 Cleanup code 2024-08-21 22:49:44 +02:00
Jaapio
3c15f3450b Fix style issues 2024-08-21 22:49:41 +02:00
Jaapio
834246694d Fix code blocks, menu and header links 2024-08-21 22:49:04 +02:00
Jaapio
801a75b836 Add improved sidebar handling 2024-08-21 22:49:03 +02:00