File not found at path: vuepress/.assets

[dimaslanjaka]

Scopes

• Installation
• Documentation
• Template (twig, xml)
• PHP sources
• Output HTML
• Output Markdown
• Appearance
• Other

Describe the bug

Parsing files

Applying transformations (can take a while)
21:22:43 ERROR     [console] Error thrown while running command "-d="src/" -t="docs/php/" --template="vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress". Message: "File not found at path: vuepress/.assets" ["exception" => League\Flysystem\FileNotFoundException^ { …},"command" => "-d="src/" -t="docs/php/" --template="vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress"","message" => "File not found at path: vuepress/.assets"]

In Filesystem.php line 389:

  File not found at path: vuepress/.assets  

Steps to reproduce

phpdoc -d="src/" -t="docs/php/" --template="vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress"

[nelson6e65]

Hi. Thanks for reporting.

Are you using a phar version of phpdoc?

What version are you using?

[dimaslanjaka]

Yes. i used phar phpdoc 3.0.0.

[dimaslanjaka]

https://github.com/dimaslanjaka/universal-framework/tree/master/libs/bin/phpdoc

this is my phpdoc

[dimaslanjaka]

phpdocumentor version ^2.9.1 as described on Doc not working as well.

[nelson6e65]

I think you are using phpDocumentor 3. Sadly, at the moment, this template is not compatible with it.

Seems that you installed locally with composer, but still using phpDocumentor 3 executable. Try to run vendor/bin/phpdoc directly instead of simply phpdoc.

And yes, PHAR bins seems to fail to locate template files also. :(

You can try to build the documentation using GitHub Actions, for example the Build job in this workflow: https://github.com/nelson6e65/php_nml/blob/master/.github/workflows/documentation.yml#L47 (Is configured to use Netlify, but you can adapt it to GitHub pages or any other).

If you like to discard if there are some problems with your config, you can try to build the documentation of this repository:

# Clone and move to phpdoc-vuepress directory

# Install dependencies
composer install
npm install

# Build API with local phpDoc configured as composer script
composer build:api

# Run VuePress server
npm run docs:dev

[nelson6e65]

If you have problems with building docs for this repository, following previous instructions, then there is some platform incompatibility (PHP version, mostly).

If you successfully build the project, then there are some issues with the global binary files you are using. Maybe duplicated phpdoc bin in different locations.

[nelson6e65]

You can try using composer scripts, like this repo, if you installed phpDocumentor 2.9.1 in your local composer.json. With this, composer will look for local install at first.

[dimaslanjaka]

I've removed phpdoc phar 3.0.0 and install via composer v.2.9.0 and now render running properly, but exceeds 500kb ?

[nelson6e65]

What do you mean with "exceeds 500Kb"?

[dimaslanjaka]

What do you mean with "exceeds 500Kb"?

i dont know, its mean too large md file.

[dimaslanjaka]

are this no alternative splitting classes.md when reached 500kb size ?
seems like, splitting other php to classes1.md when classes.md reach 500kb and so on.

[dimaslanjaka]

when classes.md more than 500kb, vuepress cannot load all contents. result is blank on classes.md (http://localhost:8080/base-url/classes.html)

[dimaslanjaka]

i build phpdoc with limit classes. but when i build with vuepress build docs-src result error page like bellow description.

Config : https://github.com/dimaslanjaka/universal-framework/tree/master/docs-src
Github Page :
build with vuepress-phpdoc, on development mode vuepress dev docs-src working, but when build result like this:
http://git.webmanajemen.com/universal-framework/
http://git.webmanajemen.com/universal-framework/php/

Static JSDoc with gulp-jsdoc3 into .vuepress/public/js (work)
http://git.webmanajemen.com/universal-framework/js/