Stable and Stark at this point are quite similar. However, Stark is using core templates, which may well change over time, potentially breaking subthemes. Stable has duplicated the core templates which will remain consistent throughout the D8 lifecycle. Unlike in D7, there is never a reason to use Stark as a basetheme. Why is it listed on the Appearance page? And worse, why are users prompted to "Learn how to build a custom theme from Stark..."?
I recommend removing Stark from the /appearance page or at least modifying the help text to express Stable or Classy are better options:
Stark
Intended as a testing platform to view default markup. This should never be subthemed as future core updates may break your theme. Instead, core supplies Classy and Stable which are better options. Numerous contributed base themes exist, as well. Learn how to build a custom themes in the Theming Guide.
Thoughts?
Comment | File | Size | Author |
---|---|---|---|
#66 | interdiff_64_66.txt | 1.09 KB | jnlar |
#66 | 2854576-66.patch | 5.78 KB | jnlar |
| |||
#65 | interdiff_64_65.txt | 912 bytes | jnlar |
#65 | 2854576-65.patch | 5.57 KB | jnlar |
| |||
#64 | interdiff_63-64.txt | 753 bytes | Tanuj. |
Comments
Comment #2
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedComment #3
mortendk CreditAttribution: mortendk as a volunteer commentedyes pleaseremove stark, its only D7 ppl that understands what stark is and as i recall there was pushback on this originally cause ppl were still unsure that there was only classy or stable, and didnt really got the concept that stark is no more.
Comment #4
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedMorton, Thanks for your reply. Do you think we should at the same time also display Classy so uninformed folks don't mistakenly believe there is no longer a core basetheme?
Comment #5
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedThis patch exposes Stable and hides Stark from the /appearance page. It also changes the descriptions for both.
Comment #7
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedOops. Patch fixed.
Comment #9
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedDrat; third time's a charm?
Comment #11
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedThis patch removes stark from the appearance page and also modifies the description telling stable or classy as better option
Comment #12
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedhere the patch changes the help text
Comment #13
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedComment #14
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedComment #16
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedComment #17
xjmThanks @Meenakshi Gupta.
This text could use some improvements for a few reasons:
stark.info.yml
withbartik.info.yml
. In that theme, the fact that it is internal is documented in the code comments, rather than in user-facing text. I did not find an existing issue to do that, so we could do it here.Also a note on core process: In the future, you should not set your own patch to "Reviewed and Tested By the Community". Drupal core uses a peer review process, so the patch should only be set to RTBC by someone else who has read and thoroughly reviewed your patch. Reference: https://www.drupal.org/patch/review
Tagging for subsystem maintainer review, as the decision as to what exactly to do with Stark should have input from the subsystem maintainer.
Comment #18
xjmOh, you might also find this reference for escaping quotes in YAML helpful: http://yaml.org/spec/current.html#id2534365
Comment #19
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commented@xjm Thanks for correcting me . I have tried to improve the text as much as possible as suggested by you and also hided the theme from the appearance page .
is it right now ?
Comment #21
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedother changes done but unable to hide stark from appearance page
Comment #22
MeenakshiG CreditAttribution: MeenakshiG at OpenSense Labs commentedComment #23
Sutharsan CreditAttribution: Sutharsan at LimoenGroen commentedComment #24
AndrewTur CreditAttribution: AndrewTur commentedAdded the hidden value to Meenakshi Gupta changes
Comment #27
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedRerolled for 8.7.x-dev.
Comment #29
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedComment #30
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedComment #32
vacho CreditAttribution: vacho at Skilld commentedPatch #30 locks good, hide Stable theme and comment the use of Stark theme. However is needed solve test problems.
Comment #33
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedvacho, you raise a very valid point that the theme should be displayed on /admin/appearance
How about if the description reads
'An intentionally plain theme for demonstrating and testing Drupal’s default HTML and CSS. Stark.x should not be used as a base theme, instead learn how to build a custom theme in the <a href="https://www.drupal.org/docs/8/theming">Theming Guide</a>.'
?Comment #34
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedNoticed a typo above and reworded to
'An intentionally plain theme for demonstrating and testing Drupal’s default HTML and CSS. Stark is not typically used as a base theme, instead learn how to build a custom theme in the <a href="https://www.drupal.org/docs/8/theming">Theming Guide</a>.'
Comment #35
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedReworded one last time.
Comment #36
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedComment #37
borisson_@NonProfit please don't queue all the tests. Running tests on drupal,.org is expensive and a change like this doesn't need to be tested on all supported php/db versions. This is a simple string change and that should not be different over different infra versions.
The hidden:true is removed from the latest patches (in #30 I think), that change should still be in the final patch.
Comment #38
NonProfit CreditAttribution: NonProfit at GoGrow.org commented@borisson_,
Thanks for the clarification. Am I correct in understanding that in a simple change like this, any one of the tests would have been sufficient?
Hidden was not included in the patch as my intent was to continue to expose the Stark to /admin/appearance and allow it to be selected through the UI. With clearer help text, isn't it preferable to allow it to be quickly enabled for testing?
Comment #39
borisson_Yes, you don't need to queue any test yourself. Just setting this issue to needs review will automatically trigger the testbot in the default configuration for the latest uploaded .patch/.diff file.
I'm not sure, in theory the stark maintainer should pick this up but @xjm already marked it as such in august 2017. I think it should be hidden but my opinion is just as strong as yours.
Comment #40
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedborisson_,
I'm certainly willing to defer on this, per your recommendation, I've added hidden to the patch.
Thank you
Comment #41
fabienlyHi ,
I tried patch 40. I haven't been able to apply the patch.
I tried different folder just in case and two drupal installation but it didn't apply.
I tried the code manually, it is working well.
So I am not sure if they are a problem with the patch or if I miss something but the code is fine.
Comment #42
NonProfit CreditAttribution: NonProfit at GoGrow.org commentedHi fabienly,
Thanks for checking this out! Sorry it's not working out.
Here's what I do and the patch applies cleanly for me:
1) Create a new folder and
git clone --branch 8.8.x https://git.drupalcode.org/project/drupal.git
2) Change directory to the root
cd drupal
2) Add the patch to the root folder
3) Apply the patch
git apply -v stark_help-2854576-40.patch
Comment #43
fabienlyHi NonProfit,
thanks for your answer.
First I a have a question : Are they difference between banch 8.8.x from drupal core clone from git and the zip named Drupal core 8.8.x-dev found on this page ?
I tried your process and your patch applied successfully as you said.
1- But the hidden parameter don't appear in stark.info.yml file after application.
I found that they are a space in front of the + so I change that in the new patch.
2- This is the process that I use to test patch :
git clone --branch 8.8.x https://git.drupalcode.org/project/drupal.git
cd drupal
composer require drush/drush
vendor/bin/drush si --db-url="mysql://root:@localhost:3306/drupalcontrib" -y
git apply -v stark_help-2854576-40.patch
With this process I am ready to test the patch before and after and check the code and the UI.
when I did that your patch didn't applied and I don't really understand why.
So I make a new patch based on your code who was great and I test to apply it with your process and mine. In both case it works.
Comment #45
fabienlyAfter investigation, I discovered my patch failed due to automated tests who try to install stark theme. But when the patch applied the hidden property all tests linked to stark theme installation failed. So I remove all stark installation in tests.
Locally all the tests pass, lets see if it is the same with the drupal.org bot.
Comment #49
vsujeetkumar CreditAttribution: vsujeetkumar at Srijan | A Material+ Company for Drupal India Association commentedRe-roll in 9.1 and fixed tests, Please review.
Comment #52
namitasaxena CreditAttribution: namitasaxena at Srijan | A Material+ Company for Drupal India Association commentedpatch re-roll in 9.2.
Comment #53
namitasaxena CreditAttribution: namitasaxena at Srijan | A Material+ Company for Drupal India Association commentedpatch re-roll in 9.2,
Comment #54
namitasaxena CreditAttribution: namitasaxena at Srijan | A Material+ Company for Drupal India Association commentedPatch re-roll for 9.2.
Kindly ignore #53.
I just realised that I had the wrong patch uploaded in #53, apologies for the noise.
Comment #56
vsujeetkumar CreditAttribution: vsujeetkumar at Srijan | A Material+ Company for Drupal India Association commentedFixing tests.
Comment #62
markconroy CreditAttribution: markconroy at Annertech commentedThis is going to need a re-roll to remove mention of seven and bartik, etc. Looks pretty simple for a novice task. And then would be great to have it merged.
Comment #63
sahil.goyal CreditAttribution: sahil.goyal as a volunteer and at Srijan | A Material+ Company for Drupal India Association commentedReroll the patch for the D10, as seven and bartik are no longer be there at D10 so i would not be there and make the Claro as default, Updating the patch.
Comment #64
Tanuj. CreditAttribution: Tanuj. as a volunteer and at Srijan | A Material+ Company for Drupal India Association commentedFixed CCF on #63.
Comment #65
jnlarUnsure what that second failing test is caused by, hopefully fixing the first one resolves it.
Comment #66
jnlarOops, missed updating comment.