revi-archive/phorge-phorge
1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-11-10 17:02:41 +01:00
Code Issues Releases Wiki Activity
phorge-phorge/webroot/rsrc/css/diviner/diviner-shared.css

154 lines
2.7 KiB
CSS
Raw Normal View History

Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
/**
* @provides diviner-shared-css
*/
.diviner-monospace {
font-family: monospace;
font-size: 13px;
}
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
.diviner-table-view {
margin: 0 16px 24px;
}
.device-phone .diviner-table-view {
margin: 0 8px 16px;
}
.diviner-table-header {
padding: 4px 16px;
background-color: {$greybackground};
border-left: 1px solid {$lightblueborder};
border-right: 1px solid {$lightblueborder};
border-top: 1px solid {$lightblueborder};
display: inline-block;
border-top-left-radius: 3px;
border-top-right-radius: 3px;
font-weight: bold;
color: {$bluetext};
}
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
.diviner-return-table-view,
.diviner-parameter-table-view {
width: 100%;
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
background: {$lightgreybackground};
border: 1px solid {$lightblueborder};
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
}
.diviner-return-table-type,
.diviner-parameter-table-type {
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
padding: 6px 8px 6px 12px;
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
white-space: nowrap;
text-align: right;
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
color: {$bluetext};
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
width: 20%;
}
.diviner-parameter-table-name {
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
padding: 6px 8px;
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
white-space: nowrap;
font-weight: bold;
}
.diviner-return-table-docs,
.diviner-parameter-table-docs {
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
padding: 6px 12px 6px 8px;
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
width: 80%;
Diviner CSS tweaks Summary: Update Diviner table layouts, make it purty. Test Plan: test many diviner pages Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6880
2013-09-04 20:50:57 +02:00
background-color: #fff;
Generate PHP function documentation in Diviner Summary: Ref T988. Various improvements: - Generate function documentation, mostly correctly. - Raise some warnings about bad documentation. - Allow `.book` files to exclude paths from generation. - Add a book for technical docs. - Exclude "ghosts" from common queries (atoms which used to exist, but no longer do, but which we want to keep the PHIDs around for in case they come back later). This is a bit rough still, but puts us much closer to being able to get rid of the old Diviner. Test Plan: See screenshots. Reviewers: btrahan, chad Reviewed By: btrahan CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6812
2013-08-27 12:14:00 +02:00
}
More Diviner style updates Summary: This adds a number of new styles for Diviner documentation. Not sure I've covered all the bases or wrote this in the most efficient manner, but passing it along now for early review before tightening everything up. Test Plan: Review various class pages. Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6888
2013-09-05 21:29:07 +02:00
.diviner-document-section {
padding: 0 0 16px 0;
}
.device-phone .diviner-document-section {
padding: 0 8px 16px 0;
}
Diviner CSS, layout updates Summary: Moves book view to use PHUIDocument, fix some other spacing issues. Test Plan: Review a number of pages in Diviner. Reviewers: epriestley Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6925
2013-09-10 16:26:00 +02:00
body .diviner-document-section .phabricator-header-view {
width: 100%;
}
Use tags/links to show extended classes in Diviner, and fix a minor empty state thing Summary: Ref T988. Show "Extends:" as linked tags. Fix the style of "This <top-level thing, like a class or function>" is not documented so it's the same as "This method is not documented.". Test Plan: Tags thing before: {F57557} Tags thing after: {F57558} Undoc before: {F57559} Undoc after: {F57560} Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6910
2013-09-08 18:13:46 +02:00
.diviner-message-not-documented {
More Diviner style updates Summary: This adds a number of new styles for Diviner documentation. Not sure I've covered all the bases or wrote this in the most efficient manner, but passing it along now for early review before tightening everything up. Test Plan: Review various class pages. Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6888
2013-09-05 21:29:07 +02:00
color: {$lightgreytext};
Use tags/links to show extended classes in Diviner, and fix a minor empty state thing Summary: Ref T988. Show "Extends:" as linked tags. Fix the style of "This <top-level thing, like a class or function>" is not documented so it's the same as "This method is not documented.". Test Plan: Tags thing before: {F57557} Tags thing after: {F57558} Undoc before: {F57559} Undoc after: {F57560} Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6910
2013-09-08 18:13:46 +02:00
font-style: italic;
margin: 16px;
More Diviner style updates Summary: This adds a number of new styles for Diviner documentation. Not sure I've covered all the bases or wrote this in the most efficient manner, but passing it along now for early review before tightening everything up. Test Plan: Review various class pages. Reviewers: epriestley, btrahan Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6888
2013-09-05 21:29:07 +02:00
}
Render Diviner atom signatures on one line Summary: Ref T988. Instead of rendering this: ClassName final class ClassName methodName final public function methodName(...) ...just render this: final class ClassName final public function methodName(...) Also link and anchor the method names. Test Plan: Before: {F57536} {F57537} After: {F57538} {F57539} Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6908
2013-09-08 18:11:59 +02:00
.diviner-atom-signature {
font-weight: normal;
}
.diviner-atom-signature-name {
font-weight: bold;
}
Link and summarize methods in the "Tasks" view of a Diviner class Summary: Ref T988. Make this more useful, and link it to the methods it describes. Test Plan: Before: {F57553} After: {F57554} Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6909
2013-09-08 18:12:33 +02:00
.diviner-list .diviner-atom-signature {
color: {$greytext};
}
.diviner-list a {
font-weight: bold;
}
Muck around with Diviner method documentation display Summary: Ref T988. Not sure about this, feel free to push back or tweak it or whatever, but I want to reduce the amount of meta-text in the method documentation. Primarily this: - Shortens "From parent implementation in ClassName:" to "ClassName". - Tries to tweak the styles a bit so that it's relatively obvious what that means (hopefully?). - Fixes an issue with tasks where some methods could be ignored. Test Plan: {F57565} Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6911
2013-09-08 18:15:22 +02:00
.diviner-method-implementation-header {
color: {$greytext};
margin-bottom: -8px;
}
.diviner-method-implementation-inherited {
color: {$darkgreytext};
}
.diviner-method-implementation-inherited .diviner-method-implementation-header {
color: {$lightgreytext};
}
/**
* Fix excessive padding between method headers and method documentation for
* methods with no inherited context.
*/
.diviner-document-section .phabricator-header-shell + .phabricator-remarkup {
padding-top: 0;
}
Clean up some more Diviner stuff Summary: Ref T988. - Render "Implements:" as tags, too. - Minor CSS tweak to tags in property lists. - Add a bunch of group patterns to the Phabricator book. - Fix some stuff with how hashes are computed and cached. - Minor tweak to reuse the Diviner engine for slightly improved performance. Test Plan: Regenerated and looked at documentation. Reviewers: chad Reviewed By: chad CC: aran Maniphest Tasks: T3811, T988 Differential Revision: https://secure.phabricator.com/D6912
2013-09-08 18:16:55 +02:00
Diviner CSS, layout updates Summary: Moves book view to use PHUIDocument, fix some other spacing issues. Test Plan: Review a number of pages in Diviner. Reviewers: epriestley Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6925
2013-09-10 16:26:00 +02:00
.diviner-list li {
line-height: 18px;
padding-bottom: 4px;
}
Diviner Book Index styles Summary: Slightly more readable, less space than current index. LMK if you hate it though. Test Plan: Look at user and dev book indexes. Reviewers: epriestley Reviewed By: epriestley CC: Korvin, aran Differential Revision: https://secure.phabricator.com/D6932
2013-09-10 18:39:50 +02:00
/* - Book Index ----------------------------------------------------------------
How big lists of book indexes get displayed
*/
.diviner-book-item {
display: block;
padding: 4px 16px;
margin: 0 -16px;
}
.diviner-book-item:hover {
text-decoration: none;
}
.device-desktop .diviner-book-item:hover {
background-color: {$lightgreybackground};
}
.diviner-book-item-title {
font-weight: bold;
}
.diviner-book-item-type {
color: {$lightgreytext};
padding-left: 8px
}
.diviner-book-item-subtitle {
display: block;
line-height: 18px;
color: {$lightbluetext};
}
Copy permalink