Does Urbit need Chinese version of its intro?

liweiz commented 5 years ago

I'm interested in translated it to Chinese. I'm also interested in translate the idea behind it, which I'm reading on and off recently, to Chinese.

I bought a star from last time public offering, too (wanted to get two, but did not have enough budget).

Please let me know what your thoughts on this.

Liwei

flowerornament commented 5 years ago

Hey @liweiz, excited to hear! Let's talk about it.

Our docs are in flux, so I'm reluctant to encourage you to translate anything there, but I think it could make a lot of sense to translate the Primer. Does that seem interesting to you, or was there a particular part of the documentation that you were interested in?

liweiz commented 5 years ago

@msutherl

Thank you for your response. What I meant was actually translating the Primer. Sorry to make you confused. Once I get Urbit's permission, I'll start to translate the Primer. My current plan is just to translate the text content atm. After I finish, I'll let you know and we can discuss the translation and how to merge into the repo. Any suggestion?

flowerornament commented 5 years ago

@liweiz I transferred this issue to the urbit.org repo where the primer lives.

primer.hoon is written in sail, which is our templating language. Let me know if you need help deciphering that – though it sounds like you plan to work from the rendered HTML – and otherwise let me know how I can help!

liweiz commented 5 years ago

@msutherl Thank you. I'll go through it. If there is any problem, I'll let you know.

liweiz commented 5 years ago

@msutherl

I have a question in this:

Nock, our machine language, is like a pico-Lisp with no symbols. It's a homoiconic purely functional machine code with 12 opcodes and one universal datatype, the noun: an acyclic binary tree that is either a number (which can also represent an arbitrarily large bytestream) or a cell, which is a pair of nouns.

Is "the noun" a concept name defined especially for Nock? It seems so. If that's the case, I'll keep it as "noun" in English instead of some confusing Chinese phrase.

ohAitch commented 5 years ago

"Noun", "cell", and "atom" are definitely being defined here as nock-specific jargon; but also definitely relate to their generic concepts of

a "noun" is any concrete thing you can refer to. If you say a sentence about what your urbit is doing, all the literal nouns in it will likely have corresponding nock nouns. (Technically so will the verbs, via sth like "the technique to [insert verb here]")
a "cell" is a cons cell, perhaps look at whether existing chinese tutorials on lisp leave the word "cell" as english or not?
an "atom" is the smallest building block of concrete things, which cannot be directly subdivided(as opposed to a cell that 'chemically' bonds together two nouns)

On Saturday, 23 February 2019, liweiz notifications@github.com wrote:

@msutherl https://github.com/msutherl

I have a question in this:

Nock, our machine language, is like a pico-Lisp with no symbols. It's a homoiconic purely functional machine code with 12 opcodes and one universal datatype, the noun: an acyclic binary tree that is either a number (which can also represent an arbitrarily large bytestream) or a cell, which is a pair of nouns.

Is "the noun" a concept name defined especially for Nock? It seems so. If that's the case, I'll keep it as "noun" in English instead of some confusing Chinese phrase.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/urbit/urbit.org/issues/46#issuecomment-466665610, or mute the thread https://github.com/notifications/unsubscribe-auth/ABxXhtaws9V4Y0iaQpUSI72IeMouaR91ks5vQWlogaJpZM4bCOus .

liweiz commented 5 years ago

@ohAitch

Thank you very much for explanations of those concepts in a way that even a layman can have a link to those concepts.

I was thinking "cell" is just something like a container with a specific structure as described in the article. Now I know where I should look.

Thanks again.

liweiz commented 5 years ago

@msutherl

In the running fakezod, mount the filesystem by running |mount %

In this step, can you let me know how to get into the running fakezod?

I'm following the "Test and Develop in Arvo" in README.

The initial translation has been done, I'm trying to take a look at the rendered version. If everything's good, I'll let my friend review my translation and revise before making a pull request here.

flowerornament commented 5 years ago

@liweiz missed the notification for this, sorry!

We're about to re-implement the website with zola, so pending review, I'll add this to the scope. The zola project hasn't quite sorted out its internationalization features, but it's coming in the next release. We can figure out a hack in the meantime.

As for preview, you can follow the instructions here: https://urbit.org/docs/getting-started/creating-a-development-ship/. If you create a PR in this repository, I'd also be interested in having a look.

liweiz commented 5 years ago

@msutherl I'm following Test and Develop in Arvo to render the page I translated. But every time I get this:

Screen Shot 2019-04-09 at 3 51 43 PM

The fresh run of all the steps with English version Primer could result in a rendered page.

Do you have any idea where I might need to look at to solve this?

Or I just create a PR for you to review it?

I'll take a look at zola after this.

flowerornament commented 5 years ago

@liweiz I think best for you to create a PR so I can have a look – it's difficult to figure out what's going on from the stack trace there. We're working on the new website now, so we'll end up re-doing the styling anyhow.

flowerornament commented 5 years ago

@liweiz we just deployed a re-implementation of the site, built with zola. It should be much easier to test now!

Looks like i18n support is coming soon.

tinnus-napbus commented 2 years ago

it's been 3 years I'll assume this has been abandoned

urbit / urbit.org

Does Urbit need Chinese version of its intro? #46