115 lines
6.7 KiB
Plaintext
115 lines
6.7 KiB
Plaintext
<!DOCTYPE html>
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="generator" content="pandoc" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
|
|
<meta name="author" content="By John Mercouris" />
|
|
<title>Common Settings and Easy Configuration</title>
|
|
<style type="text/css">
|
|
code{white-space: pre-wrap;}
|
|
span.smallcaps{font-variant: small-caps;}
|
|
span.underline{text-decoration: underline;}
|
|
div.column{display: inline-block; vertical-align: top; width: 50%;}
|
|
</style>
|
|
<style type="text/css">
|
|
a.sourceLine { display: inline-block; line-height: 1.25; }
|
|
a.sourceLine { pointer-events: none; color: inherit; text-decoration: inherit; }
|
|
a.sourceLine:empty { height: 1.2em; position: absolute; }
|
|
.sourceCode { overflow: visible; }
|
|
code.sourceCode { white-space: pre; position: relative; }
|
|
div.sourceCode { margin: 1em 0; }
|
|
pre.sourceCode { margin: 0; }
|
|
@media screen {
|
|
div.sourceCode { overflow: auto; }
|
|
}
|
|
@media print {
|
|
code.sourceCode { white-space: pre-wrap; }
|
|
a.sourceLine { text-indent: -1em; padding-left: 1em; }
|
|
}
|
|
pre.numberSource a.sourceLine
|
|
{ position: relative; }
|
|
pre.numberSource a.sourceLine:empty
|
|
{ position: absolute; }
|
|
pre.numberSource a.sourceLine::before
|
|
{ content: attr(data-line-number);
|
|
position: absolute; left: -5em; text-align: right; vertical-align: baseline;
|
|
border: none; pointer-events: all;
|
|
-webkit-touch-callout: none; -webkit-user-select: none;
|
|
-khtml-user-select: none; -moz-user-select: none;
|
|
-ms-user-select: none; user-select: none;
|
|
padding: 0 4px; width: 4em;
|
|
color: #aaaaaa;
|
|
}
|
|
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
|
|
div.sourceCode
|
|
{ }
|
|
@media screen {
|
|
a.sourceLine::before { text-decoration: underline; }
|
|
}
|
|
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
|
|
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
|
|
code span.at { color: #7d9029; } /* Attribute */
|
|
code span.bn { color: #40a070; } /* BaseN */
|
|
code span.bu { } /* BuiltIn */
|
|
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
|
|
code span.ch { color: #4070a0; } /* Char */
|
|
code span.cn { color: #880000; } /* Constant */
|
|
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
|
|
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
|
|
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
|
|
code span.dt { color: #902000; } /* DataType */
|
|
code span.dv { color: #40a070; } /* DecVal */
|
|
code span.er { color: #ff0000; font-weight: bold; } /* Error */
|
|
code span.ex { } /* Extension */
|
|
code span.fl { color: #40a070; } /* Float */
|
|
code span.fu { color: #06287e; } /* Function */
|
|
code span.im { } /* Import */
|
|
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
|
|
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
|
|
code span.op { color: #666666; } /* Operator */
|
|
code span.ot { color: #007020; } /* Other */
|
|
code span.pp { color: #bc7a00; } /* Preprocessor */
|
|
code span.sc { color: #4070a0; } /* SpecialChar */
|
|
code span.ss { color: #bb6688; } /* SpecialString */
|
|
code span.st { color: #4070a0; } /* String */
|
|
code span.va { color: #19177c; } /* Variable */
|
|
code span.vs { color: #4070a0; } /* VerbatimString */
|
|
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
|
|
</style>
|
|
<!--[if lt IE 9]>
|
|
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
|
|
<![endif]-->
|
|
</head>
|
|
<body>
|
|
<header>
|
|
<h1 class="title">Common Settings and Easy Configuration</h1>
|
|
<p class="author">By John Mercouris</p>
|
|
</header>
|
|
<p>Common settings and easy configuration recently landed in Nyxt! Now it is possible to set the value of any class/slot from the UI! You don't need to know any Lisp.</p>
|
|
<p>When you first start Nyxt, our new <code>*help*</code> page presents you with some helpful buttons to click on:</p>
|
|
<p><img src="../static/image/article/help-page.png" /></p>
|
|
<p>If you click on <code>Common settings</code>, you'll be presented with a simple menu where you can select your favorite keybinding scheme, home page URL, and zoom level.</p>
|
|
<p><img src="../static/image/article/common-settings.png" /></p>
|
|
<p>Your settings will automatically be saved and reloaded whenever you start Nyxt!</p>
|
|
<p>Don't worry about overwriting changes to your <code>init.lisp</code> file, these changes are automatically stored in a separate <code>auto-config.lisp</code> file. This file is loaded <strong>before</strong> your <code>init.lisp</code> file so that you can always override any configuration.</p>
|
|
<p>Here's what would be appended to your <code>auto-config.lisp</code> file if you clicked on <code>Use Emacs</code> in the common settings screen.</p>
|
|
<div class="sourceCode" id="configuration" data-org-language="lisp"><pre class="sourceCode commonlisp"><code class="sourceCode commonlisp"><a class="sourceLine" id="configuration-1" data-line-number="1">(DEFINE-CONFIGURATION WEB-BUFFER</a>
|
|
<a class="sourceLine" id="configuration-2" data-line-number="2"> ((DEFAULT-MODES '(EMACS-MODE CERTIFICATE-EXCEPTION-MODE WEB-MODE BASE-MODE))))</a></code></pre></div>
|
|
<p>No magic. Transparent, straightforward Lisp.</p>
|
|
<p>Beyond customization of common settings, we've added the ability to customize any class or slot from the <code>describe-slot</code> and <code>describe-class</code> commands.</p>
|
|
<p>Below you can see an example of how we can customize a class:</p>
|
|
<p><img src="../static/image/article/describe-class.png" /></p>
|
|
<p>Every single slot marked with <code>Configure</code> will allow you to input whatever value you like. Anything that is introspectable is customizable!</p>
|
|
<p>Let's run through an example: let's change the height of our status buffer.</p>
|
|
<p>First you would find the slot that you are interested in, in this case the status buffer height slot.</p>
|
|
<p><img src="../static/image/article/describe-slot-status-buffer-query.png" /></p>
|
|
<p>Then you would view the current value, the default form, and the documentation. From this screen, you can press <code>Configure</code>. After pressing <code>Configure</code>, you will be prompted for a new value. Input any valid value you would like.</p>
|
|
<p><img src="../static/image/article/configure-slot-value.png" /></p>
|
|
<p>After you supply your new value, any new windows (even after restarting Nyxt) will utilize the new value for the status buffer height! That's it!</p>
|
|
<p><img src="../static/image/article/configure-result.png" /></p>
|
|
<p>Please note: configuration changes only affect new instances of an object, not existing ones.</p>
|
|
<p>Thanks for reading :-)</p>
|
|
</body>
|
|
</html>
|