Comments (1)
Grooming notes:
We'll have two types of styles: those we expect our users to be overriding, and those we don't.
The styles that we expect our users to be overriding - must be stored in plain .css
in plugin-base
, no minification / linting or any other additional processing, at least not in this first iterations. High-level reasons: it's more user-friendly and less error-prone. At the moment there's only one such file: logo-styles.css
.
Note: same principle can be applied to .js
files we have in plugin-base
. They can be broken down into two types and moved into plugin-base-frontend
.
The styles that we don't expect our users to be overriding - can be moved to plugin-base-frontend
, can be in .scss
format, can consist of multiple source files that will be compiled into a single large styles.css
before publishing Dokka. The users can override this resulting styles.css
, but we give no hard guarantees about its stability, and thus we don't go out of our way to make it convenient.
Anton will try to make all of the mentioned build changes himself in #3470, but we have an option to ask @adam-enko for help (and it might be worth it to add him to the reviewers of the PR).
from dokka.
Related Issues (20)
- [K2] Missed `@constructor`documentation for primary constructor without parameters HOT 1
- Decapitalize Wasm targets names HOT 1
- [K1] KDoc links to a package are unresolved HOT 2
- Extension for companion object inside parent class is not shown on Companion page HOT 1
- Extension declared for parent class in inner class is not shown for parent class page
- "All Types" page generation ignore `mergeImplicitExpectActualDeclarations` flag
- Add minification for styles
- Add linting for styles
- Break down styles.css into separate components files HOT 1
- `dokkaJavadoc` task reports `Could not recognize JavadocContentGroup in SamplesTransformer` for samples
- Add microdata markup to generated html output
- Demo project for test purposes
- Infrastructure to run UI tests
- Bluetooth software Bug
- dokkaHtml fails: java.lang.NoSuchMethodError: 'void com.fasterxml.jackson.databind.type.TypeFactory.<init>(com.fasterxml.jackson.databind.util.LRUMap)' HOT 2
- integration test `it-android-0` doesn't generate HTML for `override fun onCreate(savedInstanceState: Bundle?)`
- Shorter module names
- Generic interface default methods not linked in implementors that specify the generic
- Version selector not rendered properly in all pages except for root HOT 3
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 dokka.