mirror of
https://github.com/lloeki/python-dcpu_16.git
synced 2025-12-06 09:54:39 +01:00
actual page text
This commit is contained in:
parent
c156e349e8
commit
4fdd3d7bb9
1 changed files with 63 additions and 42 deletions
53
index.html
53
index.html
|
|
@ -28,32 +28,53 @@
|
||||||
|
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<section id="main_content">
|
<section id="main_content">
|
||||||
<h3>Welcome to GitHub Pages.</h3>
|
<h3>What is this?</h3>
|
||||||
|
|
||||||
<p>This automatic page generator is the easiest way to create beautiful pages for all of your projects. Author your page content here using GitHub Flavored Markdown, select a template crafted by a designer, and publish. After your page is generated, you can check out the new branch:</p>
|
<p>A DCPU-16 implementation in Python. See <a href="http://0x10c.com/doc/dcpu-16.txt">the spec</a>.</p>
|
||||||
|
|
||||||
<pre><code>$ cd your_repo_root/repo_name
|
<h3>Goal</h3>
|
||||||
$ git fetch origin
|
|
||||||
$ git checkout gh-pages
|
<p>Many high-level implementations looked like C-in-other-language, so let's have a pythonic enough (whatever that means, but you should <a href="http://www.dabeaz.com/generators/">read</a> <a href="http://www.dabeaz.com/coroutines/">this</a>) implementation. The spirit of the thing is to be educative for everyone.</p>
|
||||||
|
|
||||||
|
<h3>Usage</h3>
|
||||||
|
|
||||||
|
<p>It's meant to be used interactively via the Python REPL as well as programmatically. A specific ASM REPL might be implemented at some point.</p>
|
||||||
|
|
||||||
|
<p>An example of a Python REPL session:</p>
|
||||||
|
|
||||||
|
<pre><code>>>> from dcpu_16 import CPU, spec_demo
|
||||||
|
>>> c = CPU(debug=True)
|
||||||
|
>>> c.load_m(spec_demo) # loads demo program
|
||||||
|
>>> c.step() # step by one instruction
|
||||||
|
<< SET
|
||||||
|
<< c.r[0x0]
|
||||||
|
<< c.m[0x0001]
|
||||||
|
<< A=0030 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=0000 J=0000 PC=0002 SP=0000 O=0000
|
||||||
|
>>> c.pc = 0xA # jump to 'loopy thing'
|
||||||
|
>>> c.step()
|
||||||
|
<< SET
|
||||||
|
<< c.r[0x6]
|
||||||
|
<< 0x000A
|
||||||
|
<< A=0030 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=000A J=0000 PC=000B SP=0000 O=0000
|
||||||
|
>>> c.reset() # reset CPU
|
||||||
|
>>> c.clear() # clear memory
|
||||||
|
>>> c.dump_r() # get CPU register state as string
|
||||||
|
'A=0000 B=0000 C=0000 X=0000 Y=0000 Z=0000 I=0000 J=0000 PC=0000 SP=0000 O=0000'
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
<p>If you're using the GitHub for Mac, simply sync your repository and you'll see the new branch.</p>
|
<h3>Status</h3>
|
||||||
|
|
||||||
<h3>Designer Templates</h3>
|
<p>As of v1.0 the CPU implementation ought to be complete according to DCPU-16 spec v1.1.</p>
|
||||||
|
|
||||||
<p>We've crafted some handsome templates for you to use. Go ahead and continue to layouts to browse through them. You can easily go back to edit your page before publishing. After publishing your page, you can revisit the page generator and switch to another theme. Your Page content will be preserved if it remained markdown format.</p>
|
<h3>Features</h3>
|
||||||
|
|
||||||
<h3>Rather Drive Stick?</h3>
|
<p>Opcodes and valcodes are as declarative as possible using decorators, leaving the dispatcher as a quasi-one-liner and leveraging <code>dict</code> power instead of <code>if</code>/<code>elif</code>.</p>
|
||||||
|
|
||||||
<p>If you prefer to not use the automatic generator, push a branch named <code>gh-pages</code> to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator written by our own Tom Preston-Werner. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.</p>
|
<p>Using functions/methods mean there are doctrings everywhere, hence documentation is both very local and as exhaustive as possible. Try <code>help(dcpu_16)</code>.</p>
|
||||||
|
|
||||||
<h3>Authors and Contributors</h3>
|
<p>You can use <code>cpu[]</code> to dispatch valcodes and get/set directly without having to handle a pointer structure.</p>
|
||||||
|
|
||||||
<p>You can <a href="https://github.com/blog/821" class="user-mention">@mention</a> a GitHub username to generate a link to their profile. The resulting <code><a></code> element will link to the contributor's GitHub Profile. For example: In 2007, Chris Wanstrath (<a href="https://github.com/defunkt" class="user-mention">@defunkt</a>), PJ Hyett (<a href="https://github.com/pjhyett" class="user-mention">@pjhyett</a>), and Tom Preston-Werner (<a href="https://github.com/mojombo" class="user-mention">@mojombo</a>) founded GitHub.</p>
|
<p>The CPU is a class, so you can instantiate a bunch of them. I might move memory outside the CPU so that it would be shared by CPU instances (SMP!)</p>
|
||||||
|
|
||||||
<h3>Support or Contact</h3>
|
|
||||||
|
|
||||||
<p>Having trouble with Pages? Check out the documentation at <a href="http://help.github.com/pages">http://help.github.com/pages</a> or contact support@github.com and we’ll help you sort it out.</p>
|
|
||||||
</section>
|
</section>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue