Comments (14)
Yeah, that site looks really nice. How much change is required in the actual chapters?
For each article, you need to add information about the template to the beginning of the page, I have already added this data in the pull request. Maybe only some small details are missing (links, typos, etc.).
from d9book.
TOC have weird spacing e.g. https://selwynpolit.github.io/d9book/book/forms.html
from d9book.
Also width is weird on https://selwynpolit.github.io/d9book/book/forms.html
from d9book.
h2 and h3 sizes seem too similar. Maybe there could be some visual cue? There is a horizontal line but it just seems like they run into each other... e.g. https://selwynpolit.github.io/d9book/book/forms.html
from d9book.
I would increase all fonts to 150%.
With 150% font thoughout the whole site:
I would also consider width in div.shell which is now set to 670px and really looks too narrow on any bigger screen.
Just too bad not using more width for the text an code.
Quick test (screenshot) with increased width of div.shell:
from d9book.
Thanks for this @alesrebec I will give these as try ASAP
from d9book.
Hello
looking at the current theme, you can notice several unpleasant moments, such as block width limitations and mismatching the block width with the text. This reduces the attractiveness of the site for me.
Proposed resolution:
Perhaps you should consider the just-the-docs theme for the site design.
I noticed that this theme was once used in the settings.
This theme has some pretty great customization and ui components.
from d9book.
@maks-oleksyuk Thanks for the thoughts. I also hate how unattractive and unprofessional the look of the site is. I did fiddle with just-the-docs theme but I think I had some problems with it. It was a while ago. I really did like many aspects of it.
Unfortunately I am really weak with front end stuff so I need some help. If you are open to a zoom call and taking a look with me, that would be awesome.
from d9book.
@alesrebec I implemented some of the changes you suggested (to the best of my knowledge.) Let me know what you think and thanks again.
from d9book.
@selwynpolit thanks for the answer
I made a quick setup to use the just-the-docs theme to demonstrate a possible look of the site.
Here's what the desktop version looks like
This theme also looks good on mobile devices.
Don't be surprised by the dark theme, I've specified it in the settings.
Also, this theme has many other settings for colors, search, breadcrumbs, and others that need to be customized.
But changing to this theme would require reworking all the .md
files to add the necessary information for the theme.
I am also not very strong in this area, but I will be happy to help in any way I can if possible.
from d9book.
It looks much better now already.
Though I agree having Just the Docs and leveraging the side menu would be perfect.
from d9book.
It's great to know that you support these changes.
I have partially worked on redesigning the site with a new theme. I'm still looking for better solutions or improvements, so any criticism or comments will be helpful.
I have created a copy of the site - https://maks-oleksyuk.github.io/d9book/bq
Here is a small summary of the changes:
- the main theme has been changed (the necessary settings have been added to the
_config.yml
file) - static content of the file is replaced by dynamic content
- updated code blocks (removed
<?php
, some places are optimized for coding standards, added type annotation for PHP 8) - minor changes in the text
- added some footnotes (warning, see also)
- copyright is placed in the footer of the site
- added 404 page
- added links to the author's repository and Twitter)
- added buttons with links to the top and to editing
Here are some photos for comparison (scale 75% to 50%)
I also have a few questions/comments
- the theme supports configuration for Analytics
- whether comments on the article are needed
- fixing some links
Thank you
from d9book.
Yeah, that site looks really nice. How much change is required in the actual chapters?
from d9book.
and that side menu is great.
from d9book.
Related Issues (20)
- Page counter is broken HOT 6
- Action Plugins HOT 11
- Derivatives Example Missing HOT 9
- Add Breadcrumb Example
- Add example for Hook Form alter in OOPS way HOT 1
- Add LocalTask Example
- Add Constraint Example
- Add Example for How to Use Entity Reference Views
- Add views examples HOT 3
- Standard white background and black text? HOT 11
- Add a LICENSE file? HOT 2
- Analytics not reporting anything HOT 5
- Typo at https://selwynpolit.github.io/d9book/twig#which-template-which-variables HOT 1
- Add accessibility section to https://selwynpolit.github.io/d9book/modules HOT 1
- We need a page on how to contribute HOT 6
- Build errors HOT 7
- Patch from a merge request HOT 4
- Multilingual sites and APIs HOT 1
- Custom domain HOT 6
- Side Navigation Not Sorted Correctly
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from d9book.