GitHub - JohnQPulp/PublicDomainPulp: Public Domain Pulp website, hosting public domain visual novels · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

JohnQPulp

PublicDomainPulp

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>331 Commits<br>331 Commits

CreativeCommonsContent @ 951c38e

CreativeCommonsContent @ 951c38e

PublicDomainPulp.Tests

PublicDomainPulp.Tests

PublicDomainPulp

PublicDomainPulp

Pulpifier @ c20f09c

Pulpifier @ c20f09c

VisualPulps

VisualPulps

.gitignore

.gitignore

.gitmodules

.gitmodules

PublicDomainPulp.slnx

PublicDomainPulp.slnx

README.md

README.md

license.txt

license.txt

View all files

Repository files navigation

Public Domain Pulp<br>Converting Books Into Open Source Visual Novels

This repository contains all the code and contents for running the Public Domain Pulp website, including all the CC0-licensed visual novels themselves.

You can read the VNs online at https://publicdomainpulp.com.

Or: You can read the VNs locally by building/running the site via the setup steps.

Or: You can read about the book-to-VN conversion process in the Documentation section further below.

About

See https://publicdomainpulp.com/about, but TL;DR:

This is a project around converting public domain books into public domain visual novels, unabridged.

The end goal is to have all public domain fiction novels readable as visual novels, each with a corresponding open source (CC0) repo that anyone can pull from and/or improve upon.

Running the Site

To start, ensure you have .NET/ASP.NET 10 installed: https://dotnet.microsoft.com/download

Check out, build, and run the site like:

git clone https://github.com/JohnQPulp/PublicDomainPulp.git<br>cd PublicDomainPulp<br>git submodule update --init --recursive<br>dotnet build PublicDomainPulp.slnx<br>dotnet run --no-build --project PublicDomainPulp --launch-profile http

Since every visual novel repo is a submdoule of this repo, the submodule update will automatically pull them all in for local reading. Simple!

Structure

PublicDomainPulp/: The ASP.NET/C# project that contains the middleware pipeline, routings, and web helpers.

PublicDomainPulp.Tests/: The integration tests for the website.

Pulpifier/: The https://github.com/JohnQPulp/Pulpifier submodule, a prerequisite for the website.

Pulpifier/Pulpifier/: The C# library that builds the visual novel pulp.txt files into html.

Pulpifier/Pulpifier.Tests/: The unit tests for the library.

Pulpifier/PulpifierCLI/: CLI tool for invoking the library.

VisualPulps/: A directory containing all of the website's CC0 visual novel contents

VisualPulps/PrideAndPrejudice/: The https://github.com/JohnQPulp/PrideAndPrejudice.git submodule (Pride and Prejudice: The Visual Novel).

VisualPulps/AStudyInScarlet/: The https://github.com/JohnQPulp/AStudyInScarlet.git submodule (A Study in Scarlet: The Visual Novel).

etc

CreativeCommonsContent/: The https://github.com/JohnQPulp/CreativeCommonsContent.git submodule containing the website's CC0 blog contents.

Contributing

While this project treats the texts of its public domain novel sources as immutable, the images and editing of the converted VNs have continuous room for improvement.

Improvements can take the form of background changes, sprite changes, line-break flow improvements, and so on. These can be either to address mistakes that can sometimes sneak into the visuals (e.g., image/text inconsistencies) or to just enhance the visuals and/or reading experience.

All visual novel repos are open for issues and pull requests, in collaborative pursuit of making them all as visually pleasing and accurate as possible.

Documentation

Here are the links to the currently written posts in the book-to-VN conversion process series:

Converting Books Into Visual Novels Part 0: The pulp.txt Format

Converting Books Into Visual Novels Part 0.5: Creating book.txt

Converting Books Into Visual Novels Part 1: The First Edit — Creating the Starter pulp.txt

Converting Books...