benjaminkott / benjaminkott/bootstrap_package

Missing tutorial on where to go after install

Open
#645 3 comments 2 reactions 0 assignees View on GitHub
feature good first issue
Dominant language
PHP
Stars
355
Forks
212
Avg merge
1h 4m
Merged PRs (30d)
31

Description

# 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:
- no styled content, fluid or CSS -- CHECK!
- Create a new template on this page -- that is what I did, right?
- Clear the predefined TypoScript setup from the textbox if any -- sounds like a great idea!
- Use this Template as Root-Level Template by checking the box -- already done!
- uncheck 'setup' and 'constants' -- now done!
- Include the bootstrap package -- way ahead of you!
- check the 'Include before all static templates' -- this is not an option, but "Include Static Templates After Basis Templates" sounds like the same thing - I knew that one was important.

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

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the existing installation introduction on GitHub and the docs.typo3.org bootstrap-package page; compare their steps for creating a root page, editing a template, and including the Bootstrap package. Document the missing post-install path, including what the Include Static Templates option should be, and verify that a fresh setup reaches a configured page rather than Hello World or a 503.

Written by the indexing model from the issue text.

Assessment

Tech stack
bootstrap
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.