EmiiBytee--np2kai-ps4/docs/PUBLISHING.md

Publicar NP2kai PS4 en GitHub desde cero

Este documento está pensado para la primera publicación del proyecto.

1. Instalar Git y GitHub CLI en EndeavourOS

sudo pacman -S git github-cli

2. Configurar tu identidad de Git

git config --global user.name "TU NOMBRE O NICK"
git config --global user.email "TU EMAIL DE GITHUB"

3. Inicializar el repositorio y NP2kai

Desde la carpeta raíz del proyecto:

./tools/init-git-repository.sh

El script crea la rama main, añade NP2kai como submódulo y prepara todos los archivos para el primer commit.

Comprueba lo que se va a publicar:

git status
git diff --cached --stat

Después crea el primer commit:

git commit -m "Release NP2kai PS4 v1.0"

4. Iniciar sesión en GitHub

gh auth login

Selecciona GitHub.com, HTTPS e inicia sesión mediante el navegador.

5. Crear el repositorio y subirlo

gh repo create np2kai-ps4 --public --source=. --remote=origin --push

No crees antes un README, .gitignore ni licencia desde la web: el proyecto ya los contiene.

6. Completar la página del repositorio

En GitHub, abre la rueda dentada de About y añade:

• Description: NP2kai PC-98 emulator port for PlayStation 4.
• Website: opcional.
• Topics: ps4, homebrew, pc98, emulator, np2kai, openorbis, libretro.

Antes de publicar, sustituye OWNER en el comando de clonación del README por tu nombre de usuario de GitHub.

7. Crear la release v1.0.0

En la página del repositorio:

1. Abre Releases.
2. Pulsa Draft a new release.
3. Crea la etiqueta v1.0.0 sobre la rama main.
4. Título: NP2kai PS4 v1.0.
5. Usa docs/RELEASE_NOTES-v1.0.md como descripción.
6. Adjunta IV0000-BREW00984_00-NP2KAIBOOTSTRAP0.pkg.
7. Marca la release como la más reciente y publícala.

El PKG debe ir como archivo de la release, no dentro del historial Git.

8. Subir cambios posteriores

git status
git add .
git commit -m "Describe brevemente el cambio"
git push

Capturas

Antes del primer push, añade a docs/ las imágenes indicadas en LEEME.md. Conviene usar JPG de buena calidad y menos de 1 MB por captura.