SumianVoice / TransVoice-Wiki

Voice Resources by Voice Art Project and others
https://wiki.sumianvoice.com
Other
33 stars 15 forks source link

Various layout & styling changes #11

Closed aliialpaca closed 2 years ago

aliialpaca commented 2 years ago

Changes

Things that need fixing/improvement

Previews

Other pages apart from the ones listed above haven't been changed.

(Most images are broken in the previews since the custom domain URLs don't apply cleanly to the Github Pages domain, the images shouldn't be broken when merged.)

It's not much apart from styling things, but I think it's a slight improvement. Let me know if there's any changes to the PR you want made before merging this.

SumianVoice commented 2 years ago

Thanks for the well organized and written PR!

It's best to avoid language like "Bad Terminology" especially as some teachers use those terms in their appropriate way. I can't think of something else that would be appropriate though apart from "Questionable Methods" and "Questionable Terminology" or something to that effect. Those two names are still not great. The original name had the same problem but only when read literally and not as a single expression "bad idea" but instead a descriptive "(bad) idea". It might be best to keep these on the same page, since it's a small topic. The \<details> tags are useful in glossary / dictionary type pages where there are huge lists (or later-to-be huge lists) so I think those should stay on the terminology headings.

Notes:

Changes requested:

aliialpaca commented 2 years ago

Changes

Notes

Might be better to keep bad methods and terms on the same page since it's a small topic, and most people looking at one section of it will be wanting to look at the other section

I split them partially so that the labels don't get confusing having the same colours with different text on the same page, although since now the labels have been generally reduced and are sort of closer in terms of meaning across both pages (e.g. red generally meaning "avoid") maybe it's less of a concern.

The other aim was to try and solve having to use <h1> to separate the two sections... I felt having to do so for the list pages might suggest the page could benefit from being split (but also because using <h1> for other sections of the page seemed a bit large). But I tweaked the <h4> styling and added summary>h3 styling rules so maybe <h1> could be used again. Let me know if you still want me to merge them again (under "Questionable Ideas" or something else).

\<h1> can have multiple instances, since the title of the page should be the overall topic, the first heading can be the major subsections of that topic and this cleans up the TOC a little since h3 and h4 are useless (they have the same size as \<p>). See vocal weight for an example of that. h1 for the intro, main section, exercises, and notes is a good formula.

I decided to look around and see if there's any precedent for using <h1> more than once in the document... in general it seems <h1> is typically used for the title at the top of the page and <h2> is used for major subsections (e.g. Wikipedia).

I ended up trying to tweak the <h4> styling to try and separate it a little more from the source text (increased font-size), here's an example of a <h4> (this test page isn't in the PR, it's in a separate test branch).

(Links to updated pages: Questionable Terms, Questionable Exercises)