diff --git a/apps/README.md b/apps/README.md index cbf31338d9..027a8fd863 100644 --- a/apps/README.md +++ b/apps/README.md @@ -11,9 +11,16 @@ Software Archives PCjs includes archives of selected software: -* IBM PC [Applications](pcx86/) and [Disk Library](/disks/pcx86/) -* Challenger 1P [Applications](c1p/) and [Disk Library](/disks/c1p/) -* DEC [PDP-10 Software](pdp10/), [PDP-11 Software](pdp11/), and [Disk Library](/disks/dec/) +* [IBM PC Application Demos](pcx86/) +* [Challenger 1P Applications](c1p/) +* [DEC PDP-10 Tapes and Diagnostics](pdp10/) +* [DEC PDP-11 Tapes and Diagnostics](pdp11/) + +You can also browse our software archives by disk: + +* [IBM PC Disk Library](/disks/pcx86/) +* [Challenger 1P Disk Library](/disks/c1p/) +* [DEC Disk Library](/disks/dec/) --- diff --git a/apps/c1p/README.md b/apps/c1p/README.md index 1ec0f2c3bc..f134a89a56 100644 --- a/apps/c1p/README.md +++ b/apps/c1p/README.md @@ -5,7 +5,7 @@ permalink: /apps/c1p/ --- Challenger 1P Applications ---- +-------------------------- [C1Pjs](/docs/c1pjs/) runs Challenger 1P (C1P) applications written in: diff --git a/apps/pcx86/README.md b/apps/pcx86/README.md index e062040327..a8f43125d8 100644 --- a/apps/pcx86/README.md +++ b/apps/pcx86/README.md @@ -1,11 +1,11 @@ --- layout: page -title: IBM PC Application Archive +title: IBM PC Application Demos permalink: /apps/pcx86/ --- -IBM PC Application Archive ---- +IBM PC Application Demos +------------------------ Below are selected [PCx86](/docs/about/pcx86/) demos of classic IBM PC applications: diff --git a/disks/README.md b/disks/README.md index 0a37946c6d..20b998c4f8 100644 --- a/disks/README.md +++ b/disks/README.md @@ -19,16 +19,21 @@ Additional selected software is available in the PCjs [Software Archives](/apps/ ### PCx86 Disk Image Formats -PCx86 works best with disk images in a **JSON** format, to save conversion time, so that's the only disk image format -you'll find in the [PCjs Project](https://github.com/jeffpar/pcjs). +PCx86 works best with disk images in a **JSON** format, to save conversion time, so that's the +only disk format you'll find in the [PCjs Project](https://github.com/jeffpar/pcjs). -If you're running the PCjs Node web server, you can convert any of our **JSON** disk images into an **IMG** file -with the [DiskDump API](/api/v1/dump), by setting the *format* parameter set to `img` instead of `json`. For example: +There are several ways you can convert a PCjs **JSON** disk image back into a binary **IMG** file: + +- Load the desired disk into a PCjs machine and click the **Save** button +- Use the [DiskDump API](/api/v1/dump) (available only in the [PCjs Node Web Server](/server.js)) + +When using the [DiskDump API](/api/v1/dump), set the *format* parameter set to `img` instead of `json`. +For example: {{ site.url }}/api/v1/dump?disk=/disks/pcx86/dos/ibm/2.00/PCDOS200-DISK1.json&format=img -As an added bonus, the PCjs Node web server automatically provides "onclick" handlers for all links to JSON-encoded disk -images, automatically invoking the API for you. +The [PCjs Node Web Server](/server.js) also generates "onclick" handlers for links to **JSON** disk +images that automatically invoke the API for you. -See [Creating PCx86-Compatible Disk Images](/docs/pcx86/#creating-pcx86-compatible-disk-images) in the -[PCx86 Documentation](/docs/pcx86/) for more information about supported disks and formats. +See [Creating PCx86-Compatible Disk Images](/docs/pcx86/#creating-pcx86-compatible-disk-images) +in the [PCx86 Documentation](/docs/pcx86/) for more information about supported disks and formats. diff --git a/disks/c1p/README.md b/disks/c1p/README.md index 0353bcfe29..320e64bf6f 100644 --- a/disks/c1p/README.md +++ b/disks/c1p/README.md @@ -1,11 +1,11 @@ --- layout: page -title: Challenger 1P Disks +title: Challenger 1P Disk Library permalink: /disks/c1p/ --- -Challenger 1P Disks ---- +Challenger 1P Disk Library +-------------------------- The project currently includes an [OS-65D Diskette](OS65D33.json), which can be loaded by the [OSI Challenger 1P (32Kb) with Disk Support](/devices/c1p/machine/32kb/). diff --git a/disks/dec/README.md b/disks/dec/README.md index c9edfb2712..eb77f95546 100644 --- a/disks/dec/README.md +++ b/disks/dec/README.md @@ -1,11 +1,11 @@ --- layout: page -title: DEC Disk Images +title: DEC Disk Library permalink: /disks/dec/ --- -DEC Disk Images ---------------- +DEC Disk Library +---------------- The DEC disk images we have archived are organized by type: diff --git a/disks/pcx86/README.md b/disks/pcx86/README.md index eaab33b41a..26c0b7eac2 100644 --- a/disks/pcx86/README.md +++ b/disks/pcx86/README.md @@ -7,7 +7,7 @@ permalink: /disks/pcx86/ IBM PC Disk Library ------------------- -This [Disk Library](/disks/pcx86/library.xml) lists all the [Disk Manifests](#disk-manifests) in the +Our [IBM PC Disk Library](/disks/pcx86/library.xml) lists all the [Disk Manifests](#disk-manifests) in the [PCjs Project](/docs/about/) and makes those disks available to any [IBM PC Machine](/devices/pcx86/machine/) in the project that uses the library. Note that most machines use the *[compiled](/disks/pcx86/compiled/library.xml)* form of the library, to reduce machine load time. @@ -18,10 +18,6 @@ machines that automatically run the software. Ideally, everything in the librar and linked to a page that describes the software in more detail, along with a live demonstration of the software, but that's not yet a reality. -For IBM PC application demos, see the [Application Archive](/apps/pcx86/), which focuses exclusively on applications. -The [Disk Library](/disks/pcx86/library.xml) is a superset, including operating systems, application software, -computer diagnostics, programming tools, and more. - ### Operating Systems * [DOS](dos/) @@ -38,7 +34,18 @@ computer diagnostics, programming tools, and more. * [MicroPro WordStar](apps/micropro/wordstar/) * [Microsoft Chart](apps/microsoft/chart/) * [Microsoft Word](apps/microsoft/word/) -* [Other...](apps/other/) +* [More...](apps/other/) + +Additional applications for which we have created special "Demo Disks" include: + +* [VisiCalc (1981)](/apps/pcx86/1981/visicalc/) +* [Executive Suite (1982)](/apps/pcx86/1982/esuite/) +* [RatBas (1982)](/apps/pcx86/1982/ratbas/) +* [Adventures in Math (1983)](/apps/pcx86/1983/adventmath/) +* [Rogue (1985)](/apps/pcx86/1985/rogue/) +* [ThinkTank (1987)](/apps/pcx86/1987/thinktank/) +* [The Dungeons of Moria (1992)](/apps/pcx86/1992/moria/) +* [More...](/apps/pcx86/) ### Games @@ -49,14 +56,14 @@ computer diagnostics, programming tools, and more. ### Shareware * [PC-SIG Library 8th Edition CD-ROM (April 1990)](shareware/pcsig08/) -* [Other...](shareware/) +* [More...](shareware/) ### Tools * [Borland Tools](tools/borland/) * [IBM Tools](tools/ibm/) * [Microsoft Tools](tools/microsoft/) -* [Other Tools](tools/misc/) +* [More...](tools/misc/) ### Tests diff --git a/docs/pcx86/README.md b/docs/pcx86/README.md index c12e1d2670..8b2a2a5dd7 100644 --- a/docs/pcx86/README.md +++ b/docs/pcx86/README.md @@ -173,7 +173,7 @@ All of the examples described above are available for [download](examples/). ### Creating PCx86-Compatible Disk Images -If you have (or find) an IMG disk image file on a server, the PCjs web server provides a +If you have (or find) an IMG disk image file on a server, the PCjs Node web server provides a [DiskDump API](/api/v1/dump) via endpoint "/api/v1/dump" that creates PCx86-compatible disks in JSON: {{ site.url }}/api/v1/dump?disk=(file|url)&format=json