diff --git a/CONTRIBUTING.ar.md b/CONTRIBUTING.ar.md index a67ba60..a6b813d 100644 --- a/CONTRIBUTING.ar.md +++ b/CONTRIBUTING.ar.md @@ -4,6 +4,7 @@ :crossed_flags: [English][EN]، +[Español][ES]، [Nederlands][NL]، [Português][PT_BR]، [Türkçe][TR]، @@ -14,6 +15,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md new file mode 100644 index 0000000..1698c1c --- /dev/null +++ b/CONTRIBUTING.es.md @@ -0,0 +1,120 @@ +# Contributing + +:crossed_flags: +[English][EN], +**Español**, +[Português][PT_BR], +[Türkçe][TR], +[العربية][AR], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[EN]:CONTRIBUTING.md +[KO_KR]:CONTRIBUTING.ko_kr.md +[PT_BR]:CONTRIBUTING.pt_br.md +[TR]:CONTRIBUTING.tr.md +[ZH_CN]:CONTRIBUTING.zh_cn.md +[ZH_TW]:CONTRIBUTING.zh_tw.md + +El código fuente en este repositorio se digitalizó manualmente a partir de impresiones en papel, por lo que los errores tipográficos y otras discrepancias se han introducido accidentalmente. El código se modificará para que sea coherente con las impresiones escaneadas: + +* [AGC impresiones para Comanche][8] +* [AGC impresiones para Luminary][9] + +## Extensiones Útiles + +GitHub tiene soporte de sintaxis para el lenguaje ensamblador AGC incorporado. Lamentablemente, su editor de código no lo hará, sin embargo, hay extensiones de lenguaje AGC que proporcionan resaltado de sintaxis para los siguientes editores: +- [Atom][Atom]† +- [CodeBlocks][CodeBlocks] +- [Eclipse][Eclipse] +- [Kate][Kate] +- [ProgrammersNotepad][ProgrammersNotepad] +- [Sublime Text 3][Sublime Text]† +- [TextPad][TextPad] +- [Vim][Vim] +- [Visual Studio Code][VisualStudioCode]† +- [jEdit][jEdit] + +† Admite formateo automático + +[Atom]:https://github.com/Alhadis/language-agc +[CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks +[Eclipse]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Eclipse +[Kate]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Kate +[ProgrammersNotepad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/ProgrammersNotepad +[Sublime Text]:https://github.com/jimlawton/AGC-Assembly +[TextPad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/TextPad +[Vim]:https://github.com/wsdjeg/vim-assembly +[VisualStudioCode]:https://github.com/wopian/agc-assembly +[jEdit]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/jEdit + +## Formateo +**Nota:** GitHub y las extensiones marcadas anteriormente asegurarán que esté utilizando el formato correcto automáticamente. + +- Usar sangría de tabulación +- Use un ancho de pestaña de 8 +- Recortar espacios en blanco al final + +## ¿Qué verifico? +Cualquier discrepancia entre los escaneos y el código fuente en este repositorio, incluyendo: + +### Comentarios +- Los comentarios en el código transcrito deben coincidir exactamente con los escaneos + - Esto podría implicar crear un error tipográfico deliberado o eliminar / agregar un comentario completo. + +### Saltos de línea +- Salto de línea *with* `R0000` en la columna 1 debe coincidir exactamente con los escaneos. +- Salto de línea *with**__out__* `R0000` en la columna 1 debe contener solo 1 o 2 líneas en blanco en una fila. + - Si hay más de 2 saltos de línea en blanco, elimine los saltos de línea adicionales. + - Líneas con `R0000` en la columna 1 no cuentan para esto. + - En las imágenes de origen, estas fueron creadas por un dígito sin imprimir en la columna 8. A 2 forzó un doble espacio (línea en blanco simple) y un 3 forzó un espacio triple (línea en blanco doble). Los valores 4-8 se definieron pero nunca se usaron. Lea más sobre esto en [#159][7] + +Por ejemplo lo siguiente: +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` +Debe convertirse: +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +### Espacios +- Los espacios entre dos caracteres en la cadena deben respetar la siguiente convención (vea la discusión en [#316][10]): + - Espacio único para nuevas palabras. + - Doble espacio para nuevas oraciones. + - Triple espacio para hendiduras. + +Por ejemplo lo siguiente: +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` +Debe convertirse: +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +## Nota + +Antes de hacer un RP, ¡asegúrese de que sus cambios sean consistentes con los escaneos! + +[0]:https://github.com/chrislgarry/Apollo-11/pull/new/master +[1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ +[2]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ +[6]:https://github.com/wopian/agc-assembly#user-settings +[7]:https://github.com/chrislgarry/Apollo-11/issues/159 +[8]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ +[9]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ +[10]:https://github.com/chrislgarry/Apollo-11/pull/316#pullrequestreview-102892741 diff --git a/CONTRIBUTING.ko_kr.md b/CONTRIBUTING.ko_kr.md index d38b9a4..822899e 100644 --- a/CONTRIBUTING.ko_kr.md +++ b/CONTRIBUTING.ko_kr.md @@ -2,6 +2,7 @@ :crossed_flags: [English][EN], +[Español][ES], [Nederlands][NL], [Português][PT_BR], [Türkçe][TR], @@ -12,6 +13,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.pt_br.md b/CONTRIBUTING.pt_br.md index f965aee..72b811e 100644 --- a/CONTRIBUTING.pt_br.md +++ b/CONTRIBUTING.pt_br.md @@ -2,6 +2,7 @@ :crossed_flags: [English][EN], +[Español][ES], [Nederlands][NL], **Português**, [Türkçe][TR], @@ -12,6 +13,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.tr.md b/CONTRIBUTING.tr.md index 761b460..a698e56 100644 --- a/CONTRIBUTING.tr.md +++ b/CONTRIBUTING.tr.md @@ -2,6 +2,7 @@ :crossed_flags: [English][EN], +[Español][ES], [Nederlands][NL], [Português][PT_BR], **Türkçe**, @@ -11,6 +12,7 @@ [한국어][KO_KR] [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [AR]:CONTRIBUTING.ar.md [KO_KR]:CONTRIBUTING.ko_kr.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.zh_cn.md b/CONTRIBUTING.zh_cn.md index 646acb9..a2fc391 100644 --- a/CONTRIBUTING.zh_cn.md +++ b/CONTRIBUTING.zh_cn.md @@ -2,12 +2,14 @@ :crossed_flags: [English][EN], +[Español][ES], [Nederlands][NL], [العربية][AR], [한국어][KO_KR], 中文 [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [AR]:CONTRIBUTING.ar.md [KO_KR]:CONTRIBUTING.ko_kr.md [ZH_CN]:CONTRIBUTING.zh_cn.md diff --git a/CONTRIBUTING.zh_tw.md b/CONTRIBUTING.zh_tw.md index 27c8407..b95cf00 100644 --- a/CONTRIBUTING.zh_tw.md +++ b/CONTRIBUTING.zh_tw.md @@ -2,6 +2,7 @@ :crossed_flags: [English][EN], +[Español][ES], [Nederlands][NL], [Português][PT_BR], [Türkçe][TR], @@ -11,6 +12,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md