From 24c073a98ed51095f0bebf101df3c9e920887cc7 Mon Sep 17 00:00:00 2001 From: Jeff Parsons Date: Mon, 18 Sep 2017 19:47:58 -0700 Subject: [PATCH] Moved the PCx86 examples from /docs to /apps --- Gruntfile.js | 4 ++-- README.md | 4 ++-- {pubs/docs => apps}/pcx86/examples/.gitignore | 0 .../pcx86/examples/1981-04-24.json | 0 .../pcx86/examples/PCDOS100.json | 0 {pubs/docs => apps}/pcx86/examples/README.md | 14 ++++++++------ .../pcx86/examples/components.css | 0 .../pcx86/examples/components.xsl | 0 .../pcx86/examples/example1.html | 2 +- .../docs => apps}/pcx86/examples/example1.xml | 0 .../pcx86/examples/example2.html | 2 +- .../docs => apps}/pcx86/examples/example2.xml | 0 .../pcx86/examples/example3.json | 0 .../pcx86/examples/example3a.html | 2 +- .../pcx86/examples/example3a.xml | 0 .../pcx86/examples/example3b.html | 2 +- .../pcx86/examples/example3b.xml | 0 .../docs => apps}/pcx86/examples/examples.zip | Bin .../pcx86/examples/ibm-basic-1.00.json | 0 .../pcx86/examples/ibm-mda-cga.json | 0 .../docs => apps}/pcx86/examples/pcx86-dbg.js | 0 {pubs/docs => apps}/pcx86/examples/pcx86.js | 0 .../pcx86/examples/visicalc.json | 0 {pubs/docs => apps}/pcx86/examples/zip.sh | 0 pubs/docs/c1pjs/README.md | 5 ++--- pubs/docs/c1pjs/embed/README.md | 17 +++++++++++------ pubs/docs/pcx86/README.md | 18 +++++++++--------- pubs/docs/personal/README.md | 4 ++-- 28 files changed, 40 insertions(+), 34 deletions(-) rename {pubs/docs => apps}/pcx86/examples/.gitignore (100%) rename {pubs/docs => apps}/pcx86/examples/1981-04-24.json (100%) rename {pubs/docs => apps}/pcx86/examples/PCDOS100.json (100%) rename {pubs/docs => apps}/pcx86/examples/README.md (85%) rename {pubs/docs => apps}/pcx86/examples/components.css (100%) rename {pubs/docs => apps}/pcx86/examples/components.xsl (100%) rename {pubs/docs => apps}/pcx86/examples/example1.html (88%) rename {pubs/docs => apps}/pcx86/examples/example1.xml (100%) rename {pubs/docs => apps}/pcx86/examples/example2.html (88%) rename {pubs/docs => apps}/pcx86/examples/example2.xml (100%) rename {pubs/docs => apps}/pcx86/examples/example3.json (100%) rename {pubs/docs => apps}/pcx86/examples/example3a.html (88%) rename {pubs/docs => apps}/pcx86/examples/example3a.xml (100%) rename {pubs/docs => apps}/pcx86/examples/example3b.html (87%) rename {pubs/docs => apps}/pcx86/examples/example3b.xml (100%) rename {pubs/docs => apps}/pcx86/examples/examples.zip (100%) rename {pubs/docs => apps}/pcx86/examples/ibm-basic-1.00.json (100%) rename {pubs/docs => apps}/pcx86/examples/ibm-mda-cga.json (100%) rename {pubs/docs => apps}/pcx86/examples/pcx86-dbg.js (100%) rename {pubs/docs => apps}/pcx86/examples/pcx86.js (100%) rename {pubs/docs => apps}/pcx86/examples/visicalc.json (100%) rename {pubs/docs => apps}/pcx86/examples/zip.sh (100%) diff --git a/Gruntfile.js b/Gruntfile.js index 082f71a80..4f6b96f0d 100644 --- a/Gruntfile.js +++ b/Gruntfile.js @@ -630,7 +630,7 @@ module.exports = function(grunt) { { cwd: "versions/pcx86/<%= pkg.version %>/", src: ["pcx86.js", "pcx86-dbg.js", "components.css", "components.xsl"], - dest: "pubs/docs/pcx86/examples/", + dest: "apps/pcx86/examples/", expand: true } ], @@ -706,7 +706,7 @@ module.exports = function(grunt) { args: [] }, "zip-examples": { - options: {cwd: "pubs/docs/pcx86/examples"}, + options: {cwd: "apps/pcx86/examples"}, cmd: "./zip.sh", args: ["v" + pkg.version + ".zip"] } diff --git a/README.md b/README.md index 0ac2093e8..ab4db161b 100644 --- a/README.md +++ b/README.md @@ -87,7 +87,7 @@ Developer Notes The [PCjs repository](https://github.com/jeffpar/pcjs) on GitHub contains everything needed to run PCjs computer simulations. All the PCjs emulators run in any modern web browser, with or without a web server, -and examples are provided for both [local](/docs/pcx86/examples/) and [remote](http://www.pcjs.org/) operation. +and examples are provided for both [local](/apps/pcx86/examples/) and [remote](http://www.pcjs.org/) operation. The project includes: @@ -103,7 +103,7 @@ JavaScript files to your browser will work. However, instructions for doing tha In fact, you can run PCjs simulations without a web server at all, using the "file:" protocol instead of "http:". However, most of the machine configurations require additional resource files (ROMs, disk images, etc), which are included in the project, but unless all the resource files are moved into a single directory (as they are in these -[Demos](/docs/pcx86/examples/)), your browser will probably be unable to load all of them, due to security restrictions. +[Examples](/apps/pcx86/examples/)), your browser will probably be unable to load all of them, due to security restrictions. Using the bundled web server is the preferred solution. The project includes a large selection of disk images, and a powerful [DiskDump](modules/diskdump/) utility that diff --git a/pubs/docs/pcx86/examples/.gitignore b/apps/pcx86/examples/.gitignore similarity index 100% rename from pubs/docs/pcx86/examples/.gitignore rename to apps/pcx86/examples/.gitignore diff --git a/pubs/docs/pcx86/examples/1981-04-24.json b/apps/pcx86/examples/1981-04-24.json similarity index 100% rename from pubs/docs/pcx86/examples/1981-04-24.json rename to apps/pcx86/examples/1981-04-24.json diff --git a/pubs/docs/pcx86/examples/PCDOS100.json b/apps/pcx86/examples/PCDOS100.json similarity index 100% rename from pubs/docs/pcx86/examples/PCDOS100.json rename to apps/pcx86/examples/PCDOS100.json diff --git a/pubs/docs/pcx86/examples/README.md b/apps/pcx86/examples/README.md similarity index 85% rename from pubs/docs/pcx86/examples/README.md rename to apps/pcx86/examples/README.md index bb6e4fcea..550801b39 100644 --- a/pubs/docs/pcx86/examples/README.md +++ b/apps/pcx86/examples/README.md @@ -1,15 +1,17 @@ --- layout: page -title: PCx86 Documentation Examples -permalink: /docs/pcx86/examples/ +title: PCx86 Examples +permalink: /apps/pcx86/examples/ +redirect_from: + - /docs/pcx86/examples/ machines: - id: example3 type: pcx86 - config: /docs/pcx86/examples/example3b.xml + config: /apps/pcx86/examples/example3b.xml --- -PCx86 Documentation Examples ----------------------------- +PCx86 Examples +-------------- This folder provides all the self-contained [PCx86](/docs/about/pcx86/) examples described in the [Documentation](/docs/pcx86/). @@ -33,4 +35,4 @@ Have fun! {% include machine.html id="example3" %} -[Return to [PCx86 Documentation](..)] +[Return to [PCx86 Documentation](/docs/pcx86/)] diff --git a/pubs/docs/pcx86/examples/components.css b/apps/pcx86/examples/components.css similarity index 100% rename from pubs/docs/pcx86/examples/components.css rename to apps/pcx86/examples/components.css diff --git a/pubs/docs/pcx86/examples/components.xsl b/apps/pcx86/examples/components.xsl similarity index 100% rename from pubs/docs/pcx86/examples/components.xsl rename to apps/pcx86/examples/components.xsl diff --git a/pubs/docs/pcx86/examples/example1.html b/apps/pcx86/examples/example1.html similarity index 88% rename from pubs/docs/pcx86/examples/example1.html rename to apps/pcx86/examples/example1.html index 7b4fb6458..8c4f1314d 100644 --- a/pubs/docs/pcx86/examples/example1.html +++ b/apps/pcx86/examples/example1.html @@ -2,7 +2,7 @@ - pcjs.org | /pubs/pcx86/examples/example1.html + pcjs.org | /apps/pcx86/examples/example1.html diff --git a/pubs/docs/pcx86/examples/example1.xml b/apps/pcx86/examples/example1.xml similarity index 100% rename from pubs/docs/pcx86/examples/example1.xml rename to apps/pcx86/examples/example1.xml diff --git a/pubs/docs/pcx86/examples/example2.html b/apps/pcx86/examples/example2.html similarity index 88% rename from pubs/docs/pcx86/examples/example2.html rename to apps/pcx86/examples/example2.html index a5a079353..ff8fc7866 100644 --- a/pubs/docs/pcx86/examples/example2.html +++ b/apps/pcx86/examples/example2.html @@ -2,7 +2,7 @@ - pcjs.org | /pubs/pcx86/examples/example2.html + pcjs.org | /apps/pcx86/examples/example2.html diff --git a/pubs/docs/pcx86/examples/example2.xml b/apps/pcx86/examples/example2.xml similarity index 100% rename from pubs/docs/pcx86/examples/example2.xml rename to apps/pcx86/examples/example2.xml diff --git a/pubs/docs/pcx86/examples/example3.json b/apps/pcx86/examples/example3.json similarity index 100% rename from pubs/docs/pcx86/examples/example3.json rename to apps/pcx86/examples/example3.json diff --git a/pubs/docs/pcx86/examples/example3a.html b/apps/pcx86/examples/example3a.html similarity index 88% rename from pubs/docs/pcx86/examples/example3a.html rename to apps/pcx86/examples/example3a.html index 7d41fb858..b60dc875b 100644 --- a/pubs/docs/pcx86/examples/example3a.html +++ b/apps/pcx86/examples/example3a.html @@ -2,7 +2,7 @@ - pcjs.org | /pubs/pcx86/examples/example3a.html + pcjs.org | /apps/pcx86/examples/example3a.html diff --git a/pubs/docs/pcx86/examples/example3a.xml b/apps/pcx86/examples/example3a.xml similarity index 100% rename from pubs/docs/pcx86/examples/example3a.xml rename to apps/pcx86/examples/example3a.xml diff --git a/pubs/docs/pcx86/examples/example3b.html b/apps/pcx86/examples/example3b.html similarity index 87% rename from pubs/docs/pcx86/examples/example3b.html rename to apps/pcx86/examples/example3b.html index e1474e434..265051316 100644 --- a/pubs/docs/pcx86/examples/example3b.html +++ b/apps/pcx86/examples/example3b.html @@ -2,7 +2,7 @@ - pcjs.org | /pubs/pcx86/examples/example3b.html + pcjs.org | /apps/pcx86/examples/example3b.html diff --git a/pubs/docs/pcx86/examples/example3b.xml b/apps/pcx86/examples/example3b.xml similarity index 100% rename from pubs/docs/pcx86/examples/example3b.xml rename to apps/pcx86/examples/example3b.xml diff --git a/pubs/docs/pcx86/examples/examples.zip b/apps/pcx86/examples/examples.zip similarity index 100% rename from pubs/docs/pcx86/examples/examples.zip rename to apps/pcx86/examples/examples.zip diff --git a/pubs/docs/pcx86/examples/ibm-basic-1.00.json b/apps/pcx86/examples/ibm-basic-1.00.json similarity index 100% rename from pubs/docs/pcx86/examples/ibm-basic-1.00.json rename to apps/pcx86/examples/ibm-basic-1.00.json diff --git a/pubs/docs/pcx86/examples/ibm-mda-cga.json b/apps/pcx86/examples/ibm-mda-cga.json similarity index 100% rename from pubs/docs/pcx86/examples/ibm-mda-cga.json rename to apps/pcx86/examples/ibm-mda-cga.json diff --git a/pubs/docs/pcx86/examples/pcx86-dbg.js b/apps/pcx86/examples/pcx86-dbg.js similarity index 100% rename from pubs/docs/pcx86/examples/pcx86-dbg.js rename to apps/pcx86/examples/pcx86-dbg.js diff --git a/pubs/docs/pcx86/examples/pcx86.js b/apps/pcx86/examples/pcx86.js similarity index 100% rename from pubs/docs/pcx86/examples/pcx86.js rename to apps/pcx86/examples/pcx86.js diff --git a/pubs/docs/pcx86/examples/visicalc.json b/apps/pcx86/examples/visicalc.json similarity index 100% rename from pubs/docs/pcx86/examples/visicalc.json rename to apps/pcx86/examples/visicalc.json diff --git a/pubs/docs/pcx86/examples/zip.sh b/apps/pcx86/examples/zip.sh similarity index 100% rename from pubs/docs/pcx86/examples/zip.sh rename to apps/pcx86/examples/zip.sh diff --git a/pubs/docs/c1pjs/README.md b/pubs/docs/c1pjs/README.md index c544e0cb9..b256bf4dc 100644 --- a/pubs/docs/c1pjs/README.md +++ b/pubs/docs/c1pjs/README.md @@ -1,7 +1,7 @@ --- layout: page title: C1Pjs Documentation -permalink: /pubs/c1pjs/ +permalink: /docs/c1pjs/ machines: - id: c1p8kb type: c1p-dbg @@ -9,11 +9,10 @@ machines: redirect_from: - /c1p/ - /c1pjs/ - - /docs/c1pjs/ --- C1Pjs Documentation ---- +------------------- C1Pjs is a JavaScript simulation of the Challenger 1P, an 8-bit 6502-based microcomputer manufactured by Ohio Scientific in 1978. The base configuration included an 8Kb BASIC-in-ROM from Microsoft diff --git a/pubs/docs/c1pjs/embed/README.md b/pubs/docs/c1pjs/embed/README.md index 5d0382295..9a0e55c6a 100644 --- a/pubs/docs/c1pjs/embed/README.md +++ b/pubs/docs/c1pjs/embed/README.md @@ -12,7 +12,7 @@ redirect_from: --- Embedding The C1Pjs Simulator ---- +----------------------------- {% include machine.html id="c1p8kb" %} @@ -36,7 +36,8 @@ Otherwise, read on to learn how embedding works, and how you can create your own its appearance. Step 1: Create a machine definition XML file ---- +-------------------------------------------- + You need an XML file that defines a Challenger configuration, listing all the components it will contain and where they will be mapped into the address space. @@ -92,7 +93,8 @@ Want to embed *multiple* simulators on a single page? No problem. Each **<mac a unique *id* attribute. Take a look at [array.xml](/devices/c1p/machine/8kb/array/) for an example. Step 2: Make sure you have all the necessary resource files ---- +----------------------------------------------------------- + In the above XML file, the ROM and Video components refer to additional resources: - 8K BASIC ROM image @ http://www.pcjs.org/devices/c1p/rom/basic-gcpatch.hex @@ -126,7 +128,8 @@ such as samples.xml: ``` Step 3: Add the C1Pjs Simulator to your web page ---- +------------------------------------------------ + Somewhere on your page, you need to add the following **<script>** element: ```html @@ -158,7 +161,8 @@ paste it into your machine definition file, inside a pair of **<panel *id*="p elements, or link to it using a single **<panel/>** element with the *ref* attribute. Step 4: Activate the C1Pjs Simulator ---- +------------------------------------ + Add the following to your page's **<body>** element: ```html @@ -174,7 +178,8 @@ The **embedC1P()** function accepts three parameters: parameter and use the default [XML stylesheet](/versions/c1pjs/1.34.0/components.xsl). Step 5: Enjoy! ---- +-------------- + All I ask is that any page that embeds the simulator also includes attribution, such as: > [PCjs](http://pcjs.org) © 2012-2017 by [Jeff Parsons](mailto:Jeff@pcjs.org) ([@jeffpar](http://twitter.com/jeffpar)) diff --git a/pubs/docs/pcx86/README.md b/pubs/docs/pcx86/README.md index c604ffecd..f972a44a8 100644 --- a/pubs/docs/pcx86/README.md +++ b/pubs/docs/pcx86/README.md @@ -20,8 +20,8 @@ through the 80386. The PCjs website provides a variety of "stock" configuration at their original clock speed, or you can create your own, by mixing, matching, and reconfiguring any of the PCx86 components listed below. -After you've read the Documentation, check out the [Examples](examples/), browse the [Source Code](/modules/pcx86/), -and experiment! +After you've read the Documentation, check out the [Examples](/apps/pcx86/examples/), +browse the [Source Code](/modules/pcx86/), and experiment! {% include machine.html id="ibm5150" %} @@ -77,7 +77,7 @@ Here's a simple machine XML definition that's more useful: ``` -[Example 1](examples/example1.html) shows the [XML](examples/example1.xml) in action. +[Example 1](/apps/pcx86/examples/example1.html) shows the [XML](/apps/pcx86/examples/example1.xml) in action. Machine definitions can also include visual elements. For example, we can include a **Run** button with the CPU component. Note that as soon as the machine is ready and the CPU starts running, the **Run** button will change to **Halt**. @@ -111,7 +111,7 @@ disks at will, we'll include some UI controls. ``` -[Example 2](examples/example2.html) shows the updated [XML](examples/example2.xml) in action. +[Example 2](/apps/pcx86/examples/example2.html) shows the updated [XML](/apps/pcx86/examples/example2.xml) in action. ### Loading Machine XML Files @@ -126,7 +126,7 @@ Inside a web page, add a <div> to contain the machine, load the *pcx86.js* ``` -In fact, this is exactly what we did in [Example 2](examples/example2.html). +In fact, this is exactly what we did in [Example 2](/apps/pcx86/examples/example2.html). *embedPCx86()* accepts 4 parameters: @@ -158,7 +158,7 @@ To create a configuration that includes the PCx86 Debugger, you need to: - Add debugger controls to the Control Panel, such as Run, Step, Reset, etc; - Change your web page to load *pcx86-dbg.js* instead of *pcx86.js*. -Take a look at [Example 3A](examples/example3a.html) ([XML](examples/example3a.xml)). +Take a look at [Example 3A](/apps/pcx86/examples/example3a.html) ([XML](/apps/pcx86/examples/example3a.xml)). The debugger gives you access to more capabilities than mere debugging. For example, you can use the **load** command to load diskette sectors into memory ("l [addr] [drive #] ...") or the **dump** command to dump an entire @@ -166,13 +166,13 @@ diskette as JSON ("d disk [drive #]"). You can also **halt** a machine ("h") an ("d state"). You can save that state in a .json file, and then use that state to initialize a new machine (as long as it uses the same machine *id*). -In fact, [Example 3B](examples/example3b.html) ([XML](examples/example3b.xml)) -does just that, using JSON dumps created from [Example 3A](examples/example3a.html) after starting VisiCalc. +In fact, [Example 3B](/apps/pcx86/examples/example3b.html) ([XML](/apps/pcx86/examples/example3b.xml)) +does just that, using JSON dumps created from [Example 3A](/apps/pcx86/examples/example3a.html) after starting VisiCalc. See the *state* property on the [Computer](computer/) component for more information on state files. ### Running PCx86 On Your Own Server -All of the examples described above are available for [download](examples/). +All of the examples described above are available for [download](/apps/pcx86/examples/). ### Creating PCx86-Compatible Disk Images diff --git a/pubs/docs/personal/README.md b/pubs/docs/personal/README.md index 4a297d27b..b54534d46 100644 --- a/pubs/docs/personal/README.md +++ b/pubs/docs/personal/README.md @@ -14,8 +14,8 @@ adventures in PC debugging: decoding and disabling [dBASE III Copy-Protection](# ### dBASE III Copy-Protection -* [dBASE III Debugging Notes](/docs/personal/1984-09-16--DBASE_III_DEBUG.pdf) -* [dBASE III Patching Procedure](/docs/personal/1984-09-25--DBASE_III_PATCH.pdf) +* [dBASE III Debugging Notes](1984-09-16--DBASE_III_DEBUG.pdf) +* [dBASE III Patching Procedure](1984-09-25--DBASE_III_PATCH.pdf) NOTE: Copies of the [dBASE III](/disks/pcx86/apps/other/dbase3/1.0/) disks can be found in our [IBM PC Disk Library](/disks/pcx86/).