MADS Knowledge-Base

[+JAC!]

Hello tebe,

 

When I try to recompile some older source with a recent (2.1.5) MADS, I get an error for using .DB. Is that by intention?

 

Kind regards, Peter

[tebe]

https://mads.atari8.info/pl/index.html

v 2.0.4

 

- .DB, .DW removed

[+JAC!]

3 hours ago, tebe said:

https://mads.atari8.info/pl/index.html

v 2.0.4

 

- .DB, .DW removed

Thanks, I was checking the English docs and the still mention them because they are too old. Also these (which are included in the download/used in WUDSN) still have them.
https://github.com/tebe6502/Mad-Assembler/blob/master/doc/mads_eng.html

I see I have to update WUDSN with many things regarding MADS. I really like the idea of having the docs at github with the cool formatting. Year ago I started an English translation of the Polish MADS docu, but got stuck half way. Also because there was no proper change tracking (change in original vs. change in English). This mkdocs tools combined with git looks really great. Esp. because sections are separate pages now. I've forked your repo for a test and did an initial translation (no proof reading done yet).

 

What Do you think? Would it be possible to have the PL and EN in one (your) repo as separate folders? This way you could publish it on the main site.

[mirao]

I'm using auto Google translate: https://mads-atari8-info.translate.goog/pl/?_x_tr_sl=auto&_x_tr_tl=en&_x_tr_hl=en-US

Only drawback is that if I perform a search query there, texts and URLs from the result are back in Polish.

For me it would be enough to have one up-to-date HTML page in English. Actually it is https://mads.atari8.info/mads_eng.html, but it's not updated from latest MADS version.

[+JAC!]

9 hours ago, mirao said:

I'm using auto Google translate: https://mads-atari8-info.translate.goog/pl/?_x_tr_sl=auto&_x_tr_tl=en&_x_tr_hl=en-US

Only drawback is that if I perform a search query there, texts and URLs from the result are back in Polish.

For me it would be enough to have one up-to-date HTML page in English. Actually it is https://mads.atari8.info/mads_eng.html, but it's not updated from latest MADS version.

And these are exactly the 3 things I'd like to fix:

- proper translation with proof reading

- working online version

- up-to-date single file version

 

MADS itself is very stable now, because the main development has shifted to Mad Pascal on top of it. Therefore I think it is a good thing to do now.

[flashjazzcat]

44 minutes ago, JAC! said:

MADS itself is very stable now

I'm in a 'never update' state at the moment, but I guess I'll have to bite the bullet sooner or later. I already know some source code will require alteration.

[+JAC!]

Thanks to the help from tebe I have now setup a branch of the docs and work on the translation and restructuring.

The worked in progress can be found here and will be merged back to the main branch whenever something is finished.

 

English: https://www.wudsn.com/tmp/projects/mads/en/

Polish: https://www.wudsn.com/tmp/projects/mads/pl/

 

Done: 

- Index with change history from 2.1.5 down to 2.0.5
- Introduction

Next: Complete change history for 2.0.4 and below

 

If you find something that's not right in the already completed parts, please create an issue via https://github.com/peterdell/mad-assembler-mkdocs/issues

[fenrock]

On 5/7/2023 at 8:01 PM, JAC! said:

Thanks to the help from tebe I have now setup a branch of the docs and work on the translation and restructuring.

The worked in progress can be found here and will be merged back to the main branch whenever something is finished.

 

English: https://www.wudsn.com/tmp/projects/mads/en/

Polish: https://www.wudsn.com/tmp/projects/mads/pl/

 

Done: 

- Index with change history from 2.1.5 down to 2.0.5
- Introduction

Next: Complete change history for 2.0.4 and below

 

If you find something that's not right in the already completed parts, please create an issue via https://github.com/peterdell/mad-assembler-mkdocs/issues

Are you looking for contributions that change the Polish pages to English, e.g. https://github.com/peterdell/mad-assembler-mkdocs/blob/master/docs/en/docs/arrays.md

i.e. is this a case of plowing through a lot of pages and translating them?

If so, I wouldn't mind doing a few in spare time. I'd be google-translating, and then fixing into corrected English as I don't know a word of Polish.