Offline reference documentation is missing "all.css"

[NathanStrutz]

Most appropriate sub-area of p5.js?

• Accessibility (Web Accessibility)
• Build tools and processes
• Color
• Core/Environment/Rendering
• Data
• DOM
• Events
• Friendly error system
• Image
• IO (Input/Output)
• Localization
• Math
• Unit Testing
• Typography
• Utilities
• WebGL
• Other (specify if possible) - Documentation

Details about the bug:

• p5.js version: v1.2.0
• Web browser and version: All
• Operating System: All
• Steps to reproduce this:

1. Visit the online reference docs at https://p5js.org/reference/
2. Download the offline reference from the link, which points to https://p5js.org/offline-reference/p5-reference.zip
3. Unzip the file and open index.html
4. Note that index.html points to ./assets/all.css which does not exist in the zip file or extracted folder
5. Notice the unstyled look of the offline reference documentation.

[welcome]

Welcome! 👋 Thanks for opening your first issue here! And to ensure the community is able to respond to your issue, be sure to follow the issue template if you haven't already.

[rt1301]

@montoyamoraga @limzykenneth @NathanStrutz I would like to work on this issue if possible. This issue is related to the p5.js-website project in my opinion so I think it would be more suitable to transfer this issue there. Thanks!

[montoyamoraga]

hi @NathanStrutz thanks for pointing this out!

hi @rt1301 thanks! i transferred this to the p5.js website repo and i assigned it to you, good luck!

[rt1301]

@montoyamoraga
In the grunt file of p5.js-website project, the following code is written for offline reference:
{ expand: true, cwd: '<%= config.dist %>/assets', src: 'css/all.css', dest: '<%= config.src %>/offline-reference/' },
This is the code responsible for compressing the reference section and making it a zip file right?

[montoyamoraga]

hi @rt1301 i'm not really sure, but it looks in the right direction to me ~
let me tag @limzykenneth who knows more :)

[limzykenneth]

@rt1301 That's part of it. The actual compression is defined in this step but before that is run the offline-reference folder needs to be populated with files that are not already in it, which are duplicate files of the main website. To get a better idea about what are copied over before zipping, you can download the offline reference then compare the files in there against what's actually tracked in the repo.

[rt1301]

@limzykenneth, I have added some changes to the offline reference, and in the dist directory, the offline-reference zip file contains the updated changes. Still, while trying to download it from the locally hosted website, the old offline-reference zip file is downloaded. Can you suggest to me how to fix this?

[limzykenneth]

@rt1301 The URL for that link is hardcoded to point to p5js.org. You can just run the build step and have a look at the generated zip file in the dist folder to see if it worked correctly. If that zip file looks fine, it will be fine on the live website when deployed.