mirror of
https://github.com/evennia/evennia.git
synced 2026-03-20 06:46:31 +01:00
Updated HTML docs.
This commit is contained in:
parent
6056e833a9
commit
55eec303d4
39 changed files with 263 additions and 434 deletions
|
|
@ -64,9 +64,9 @@
|
|||
<li><a class="reference internal" href="#">Beginner Tutorial</a><ul>
|
||||
<li><a class="reference internal" href="#things-you-need">Things you need</a><ul>
|
||||
<li><a class="reference internal" href="#a-command-line">A Command line</a></li>
|
||||
<li><a class="reference internal" href="#a-fresh-game-dir">A fresh game dir?</a></li>
|
||||
<li><a class="reference internal" href="#a-mud-client">A MUD client</a></li>
|
||||
<li><a class="reference internal" href="#a-text-editor-or-ide">A text Editor or IDE</a></li>
|
||||
<li><a class="reference internal" href="#a-fresh-game-dir">A fresh game dir?</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
|
@ -150,38 +150,35 @@
|
|||
<div><p>Note that we usually only show forward-slashes <code class="docutils literal notranslate"><span class="pre">/</span></code> for file system paths. Windows users should mentally convert this to back-slashes <code class="docutils literal notranslate"><span class="pre">\</span></code> instead.</p>
|
||||
</div></blockquote>
|
||||
</section>
|
||||
<section id="a-fresh-game-dir">
|
||||
<h3>A fresh game dir?<a class="headerlink" href="#a-fresh-game-dir" title="Permalink to this headline">¶</a></h3>
|
||||
<p>You should make sure you have successfully <a class="reference internal" href="../../Setup/Installation.html"><span class="doc std std-doc">installed Evennia</span></a>. If you followed the instructions you will already have created a game-dir. You could re-use that or make a new one only for this tutorial, it’s up to you.</p>
|
||||
<p>If you already have a game dir and want a separate one for the tutorial, use <code class="docutils literal notranslate"><span class="pre">evennia</span> <span class="pre">stop</span></code> to halt the running server and then <a class="reference internal" href="../../Setup/Installation.html#initialize-a-new-game"><span class="std std-doc">Initialize a new game dir</span></a> somewhere else (<em>not</em> inside the previous game dir!). We refer to it everywhere as <code class="docutils literal notranslate"><span class="pre">mygame</span></code>, so you may want to use that name too.</p>
|
||||
</section>
|
||||
<section id="a-mud-client">
|
||||
<h3>A MUD client<a class="headerlink" href="#a-mud-client" title="Permalink to this headline">¶</a></h3>
|
||||
<p>You might already have a MUD-client you prefer. Check out the <a class="reference internal" href="../../Setup/Client-Support-Grid.html"><span class="doc std std-doc">grid of supported clients</span></a>.
|
||||
If telnet’s not your thing, you can also just use Evennia’s web client in your browser.</p>
|
||||
<p>Make sure you know how to connect to and log in to your locally running Evennia server.</p>
|
||||
<blockquote>
|
||||
<div><p>In this documentation we often use the terms ‘MUD’, ‘MU’ or ‘MU*’ interchangeably to represent all the historically different forms of text-based multiplayer game-styles, like MUD, MUX, MUSH, MUCK, MOO and others. Evennia can be used to create all those game-styles and more.</p>
|
||||
</div></blockquote>
|
||||
</section>
|
||||
<section id="a-text-editor-or-ide">
|
||||
<h3>A text Editor or IDE<a class="headerlink" href="#a-text-editor-or-ide" title="Permalink to this headline">¶</a></h3>
|
||||
<p>You need a text-editor to edit Python source files. Most everything that can edit and output raw
|
||||
text works (so not Word).</p>
|
||||
<p>You need a text-editor to edit Python source files. Most everything that can edit and output raw text works (so not Word).</p>
|
||||
<ul class="simple">
|
||||
<li><p><a class="reference external" href="https://www.elegantthemes.com/blog/resources/best-code-editors">Here’s a blog post summing up some of the alternatives</a> - these things don’t change much from year to year. Popular choices for Python are PyCharm, VSCode, Atom, Sublime Text and Notepad++. Evennia is to a very large degree coded in VIM, but that’s not suitable for beginners.</p></li>
|
||||
</ul>
|
||||
<div class="admonition important">
|
||||
<p class="admonition-title">Important</p>
|
||||
<p>Use spaces, not tabs</p>
|
||||
<p>Use spaces, not tabs
|
||||
Make sure to configure your editor so that pressing TAB inserts <em>4 spaces</em> rather than a Tab-character. Since Python is whitespace-aware, this will make your life a lot easier.</p>
|
||||
</div>
|
||||
<blockquote>
|
||||
<div><p>Make sure to configure your editor so that pressing TAB inserts <em>4 spaces</em> rather than a Tab-character. Since Python is whitespace-aware, this will make your life a lot easier.</p>
|
||||
</div></blockquote>
|
||||
</section>
|
||||
<section id="a-fresh-game-dir">
|
||||
<h3>A fresh game dir?<a class="headerlink" href="#a-fresh-game-dir" title="Permalink to this headline">¶</a></h3>
|
||||
<p>You should make sure you have <a class="reference internal" href="../../Setup/Installation.html"><span class="doc std std-doc">installed Evennia</span></a>. If you followed the instructions you will already have created a game-dir.</p>
|
||||
<p>You could re-use that or make a new one only for this tutorial, it’s up to you.</p>
|
||||
<p>If you already have a game dir and want a separate one for the tutorial, use <code class="docutils literal notranslate"><span class="pre">evennia</span> <span class="pre">stop</span></code> to halt the running server and then <a class="reference internal" href="../../Setup/Installation.html#initialize-a-new-game"><span class="std std-doc">Initialize a new game dir</span></a> somewhere else (<em>not</em> inside the previous game dir!). We refer to it everywhere as <code class="docutils literal notranslate"><span class="pre">mygame</span></code>, so you may want to do the same.</p>
|
||||
<p>You should now be ready to move on to the <a class="reference internal" href="Part1/Beginner-Tutorial-Part1-Overview.html"><span class="doc std std-doc">first lesson</span></a></p>
|
||||
<p>You should now be ready to move on to the <a class="reference internal" href="Part1/Beginner-Tutorial-Part1-Overview.html"><span class="doc std std-doc">first part of the tutorial</span></a> (in the future, use the <code class="docutils literal notranslate"><span class="pre">previous</span> <span class="pre">|</span> <span class="pre">next</span></code> buttons on the top/bottom of the page to progress)!</p>
|
||||
<details>
|
||||
<summary>
|
||||
Click here to expand a list of all Beginner-Tutorial sections (all parts).
|
||||
Click here to see the full index of all parts and lessons of the Beginner-Tutorial.
|
||||
</summary>
|
||||
<div class="toctree-wrapper compound">
|
||||
<ul>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue