// ==UserScript==
// @name npmjs.com visual tweaks
// @namespace http://tampermonkey.net/
// @version 0.7.9
// @description Styles npmjs.com README pages similarly to GitHub's (font, size, colors, but not syntax highlighting), and makes the content wider
// @author joeytwiddle
// @copyright 2018, Paul "Joey" Clark (http://neuralyte.org/~joey)
// @license MIT
// @match https://www.npmjs.com/*
// @grant GM_addStyle
// ==/UserScript==
// Motivation: I didn't like the visual context switching between reading Github READMEs and npm READMEs, so I made READMEs on npm look similar to READMEs on Github.
(function() {
'use strict';
const floatTheSidebar = true;
// I want to scale down the fonts and everything else a bit. This was an easy way to do that.
//GM_addStyle('.container { transform: scale(0.92); transform-origin: 50% 0; }');
// Fill (almost) the whole width of the screen, like Wide-Github does.
//GM_addStyle('.container { width: 98%; max-width: 100%; }');
GM_addStyle("#top { max-width: 100%; }");
// OK not the entire width. Stop the width when it starts to look ugly.
GM_addStyle("#top { max-width: 1500px; }");
// Set fonts like GitHub
GM_addStyle('#readme { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Source Sans Pro", "Lucida Grande", sans-serif; }');
GM_addStyle('#readme { font-family: line-height: 1.5;}');
//GM_addStyle('pre, code, kbd, samp { font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; }');
// Set fonts how I like them (configurable through browser)
//GM_addStyle('pre, code, kbd, samp { font-family: monospace; }');
// I don't know why, but "monospace" shrinks the font considerably on my Linux, whilst "monospace,monospace" does not.
// Also "monospace,monospace" is what the site itself adopted on 2018/3/22. This rule will just ensure it stays this way!
GM_addStyle('pre, code, kbd, samp { font-family: monospace,monospace; }');
// Set font sizes like GitHub
// A snippet of code appearing within a paragraph
GM_addStyle('code { font-size: 85%; }');
// A line of code on its own
GM_addStyle('pre > code { font-size: 100%; }');
// A block of code
GM_addStyle('pre { font-size: 82%; line-height: 1.4; }');
// Darker text
if (navigator.userAgent.match(/Mac OS X/)) {
// Weirdly, on Mac, the font strokes on npmjs.com appear slightly thinner than those on Github, for a reason I cannot understand. To compensate, I use a darker color.
GM_addStyle('.markdown p, .markdown li { color: #111; }');
} else {
// Github 2016 (my preference)
GM_addStyle('.markdown p, .markdown li { color: #333; }');
// Github 2017
//GM_addStyle('.markdown p, .markdown li { color: #24292e; }');
}
// The boxes around inline code snippets
GM_addStyle('code { border-radius: 3px; padding: 0.2em 0.4em !important; }');
// Links should be normal weight (npm makes them bolder)
GM_addStyle('.markdown p a, .markdown li a { font-weight: initial; }');
// Padding around code blocks and snippets
// A snippet of code appearing within a paragraph
GM_addStyle('code { padding: 0.2em 0.2em; }');
// A line of code on its own
GM_addStyle('pre > code { padding: 1em 2em; }');
// Reduce the large padding inside code blocks to be more like Github's
GM_addStyle('pre { padding: 1.1rem !important; }');
// Lighter background on code blocks and snippets
GM_addStyle('.vistweaks .markdown .highlight, .vistweaks .markdown code, .vistweaks .markdown pre { background-color: #f6f8fa; }');
// More of a gap after each paragraph? Wasn't actually needed. The problem was wrapping due to insufficient width.
//GM_addStyle('div, .highlight { padding-bottom: 20px; }');
// Thicker font for section headers
GM_addStyle('.markdown h1, .markdown h2, .markdown h3, .markdown h4, .markdown h5, .markdown h6 { font-weight: 600; }');
// Use the npm font for section headers, even though we aren't using it for main text. (This is a divergence from Github's markdown scheme.)
//GM_addStyle(".markdown h1, .markdown h2, .markdown h3, .markdown h4, .markdown h5, .markdown h6 { font-family: 'Source Sans Pro', 'Lucida Grande', sans-serif; }");
// There was absolutely no padding on the new styling. At low widths, the text could touch the edge of the screen. No thanks!
//GM_addStyle(".markdown { padding-left: 1em; padding-right: 1em; }");
// Better to do it for the whole content, including the tabs across the top
//GM_addStyle("#top { padding-left: 1em; padding-right: 1em; }");
// At larger widths we can enjoy greater padding
GM_addStyle("#top { padding-left: 2%; padding-right: 2%; }");
// Make the sidebar look like a hovering card
// Sadly this now reaches all the way down to the bottom of the README
GM_addStyle(".package__rightSidebar___9dMXo { padding: 0.9em 1.8em 0.1em 1.8em !important; margin-top: 2.75rem; }");
//GM_addStyle(".package__rightSidebar___9dMXo { box-shadow: 0 0 8px 0 #00000033; }");
GM_addStyle(".package__rightSidebar___9dMXo { border: 1px solid #0002 }");
// This widens the gap between the two panels, so the shadow doesn't overlap too much
GM_addStyle(".markdown { padding-right: 0.5em; }");
// This graph does not scale down well to low resolutions, with or without our changes. I will wait and see if they fix that.
// This is one way of increasing the specificity of our selectors
// It could also be used to toggle our tweaks on and off
// But I have not yet added it to the selectors above
document.body.classList.add("vistweaks");
// Drop the huge margins above section titles
GM_addStyle(".vistweaks .markdown h1, .vistweaks .markdown h2, .vistweaks .markdown h3, .vistweaks .markdown h4, .vistweaks .markdown h5, .vistweaks .markdown h6 { margin-top: 1em; padding-top: 0; }");
// Indent lists
GM_addStyle(".vistweaks .markdown ul, .vistweaks .markdown ol { padding-left: 2em; }");
if (floatTheSidebar) {
var checkTheSidebar = function () {
const mainLeftPanel = document.querySelector('.package__main___3By_B');
if (!mainLeftPanel) return;
const readmeElement = document.querySelector('#readme');
if (!readmeElement) return;
const sidebarElement = document.querySelector('.package__rightSidebar___9dMXo');
if (!sidebarElement) return;
if (sidebarElement.parentNode.classList.contains('visual-tweaks-userscript-sidebar-container')) {
//console.log("We have already handled this sidebar");
return;
}
mainLeftPanel.classList.remove('w-two-thirds-ns');
mainLeftPanel.classList.remove('mr3-ns');
const sidebarContainer = document.createElement('div');
sidebarContainer.className = 'visual-tweaks-userscript-sidebar-container';
sidebarContainer.style.float = 'right';
sidebarContainer.style.background = 'white';
sidebarContainer.style.paddingLeft = '3em';
sidebarContainer.style.paddingBottom = '3em';
// Move the width from the sidebar to the container
sidebarElement.classList.remove('w-third-ns');
sidebarContainer.classList.add('w-third-ns');
sidebarContainer.appendChild(sidebarElement);
GM_addStyle(".markdown { padding-right: 0; }");
// Clear the existing margin. Leave a small margin for the shadow.
GM_addStyle(".mr3-ns { margin-right: 4px; }");
//readmeElement.appendChild(sidebarElement);
readmeElement.parentNode.insertBefore(sidebarContainer, readmeElement);
// BUG: At low resolutions, normally the sidebar will break to below the readme. But with our changes, the sidebar appears above the readme!
// If an image appears above the fold, and it takes 100% of the width, then it will cause the document to push down below the floating sidebar
// For an example of such a page: https://www.npmjs.com/package/passport
// Of course this rule will apply to all images, even those later down on the page
GM_addStyle(".vistweaks .markdown img { max-width: 66%; }");
};
checkTheSidebar();
new MutationObserver(mutations => checkTheSidebar()).observe(document.body, { childList: true, subtree: true });
}
})();