puput icon indicating copy to clipboard operation
puput copied to clipboard

Document how to extend the default template

Open marctc opened this issue 7 years ago • 5 comments

As users couldn't select a template (for the moment https://github.com/APSL/puput/issues/42) it could be useful have a section in the documentation that explains how to extend the default template. This will avoid further issues like https://github.com/APSL/puput/issues/63

marctc avatar Mar 22 '17 15:03 marctc

+1

yarsanich avatar Mar 22 '17 20:03 yarsanich

+1

MiltonLn avatar Apr 13 '17 16:04 MiltonLn

+1

sabueso avatar Apr 30 '17 22:04 sabueso

As modifying an existing set of templates is such an involved procedure, I often think comprehensive documentation of the variables, methods, template tags that are available for a Django app would be a much better approach. Any JavaScript dependencies would also need to be noted. An unstyled skeleton template might also be useful, as an example, but all the CSS styling and anything else extraneous needs to be removed. Using Django Compressor might be useful, but it is a site-wide decision, and one for the end of the development process--including it in a Django app only confuses the initial development.

I have been dealing with this problem for Puput today, and after copying the entire Puput template structure to my project override template folder, I spent the afternoon iteratively deleting stuff until I got to a base I could work with....

pjmcdermott avatar Nov 09 '17 20:11 pjmcdermott

+1

Followthevu avatar Oct 29 '21 17:10 Followthevu