benjaminkott / bootstrap_package

Bootstrap Package delivers a full configured theme for TYPO3, based on the Bootstrap CSS Framework.
https://www.bootstrap-package.com/
MIT License
338 stars 206 forks source link

Missing tutorial on where to go after install #645

Open yurigoul opened 5 years ago

yurigoul commented 5 years ago

Support

After reading a couple of tutorials on Typo3, including a video on BE templates and some front-end templating stuff. I have installed 8.7.24 on mamp and try to get the bootstrap package going.

I have installed the bootstrap package 10.05 by uploading it through the extensions panel, it is there, I can change the config - but when I make a new first page with with "Use as Root Page" set to enabled nothing happens but a fat error 503 page. And after going to templates and adding a template all I have is a "Hello World" page.

The website at www.bootstrap-package.com contains more information about typo3, but not about how to activate the templates and what the different package content elements do and how to add them after creating your first page. Or so it seems.

There is a tutorial at https://docs.typo3.org/typo3cms/extensions/bootstrap_package/ with the different extra options for configuration, but they contain no installation info.

I have now added a couple of different include page tsconfig from the extension to the page under resources, but since I started from scratch I am back at error 503. I have added the BE layouts, categories for content elements and all content elements. And how can I know that the difference is between TCEFORM and TCEMAIN?

Time to add the template again, see what happens. Wish me luck!

Nope, back into hello world territory. how can that be, I have added the Bootstrap backend templates, this should mean that the content fields I use are connected somewhere to a layout, or am I expecting too much?

I have now added the bootstrap package in the include static templates during my edit template. Added fluid content elements for good measure, what do I know. Include static templates? Lets try, the more the merrier!

Well, I am at least greeted with "hello world" - got that going for me, which is nice!

Now I am looking at the page on github that it has an installation introduction, great! Lemme see:

Now it seems to work. What a ride!!!

benjaminkott commented 5 years ago

@yurigoul WOW! Thank you so much for describing your efforts to get this running. As longtime TYPO3 Users, we seriously take too much stuff for granted. I will try to provide better resources on the installation and guidance. Thanks a lot for the reminder.

yurigoul commented 5 years ago

@benjaminkott thanks for your reaction - I was ill and then otherwise engaged for a a while hence my late reply. With your permission I could add some follow ups from time to time - for instance:

I tried to add my own css file using page.includeCSS in the setup field of the template and a simple hand written css file that should turn the body background color to red - in order to test if it worked.

I have now read a lot of pages in tutorials and examples to find out why it did not work, and if I was maybe using the wrong path reference. Until I looked at the configuration of the extension on ADMIN TOOLS/Extensions and checked the box for "Disable Processing of LESS/Scss files" on the Features tab.

For some reason leaving this unchecked, makes it so that a simple css line, like the one below is not seen as valid and therefor not included: body {background-color: #f00 !important;}

It is nice that I solved it, but I am a bit worried now. I like to write plain css by hand. I also do not want to break the option to update the boostrap_package in the future - hence my preference to not fork the package but extend it. But whatif a future version has more of a preference for LESS or Scss?

danaron commented 5 years ago

@yurigoul Did you really turn on the Include Static Templates After Basis Templates in the main template? What is this good for? Thank you for helping me out. Till now, on all the installations I never turned this option on...