31:T58d,introduction = md` Ji (pronounced *gee*) is a programming language that uses symbols as functions. Ji is an attempt to create a code file that is as fluent as a written poem and power enough to describe an entire opera. Ji - Code outside of the box. This introduction section is meant to give you a quick overview of what Ji is and how it works. For more information visit the following: - [Ji Language](/@elisk/ji-language) - An introduction to Ji and basic usage guide - [Ji Source Code](/@elisk/ji) — Additionally to the actual source code involved in making Ji work this notebook contains documentation for the various parts that make up the Ji compiler - [Ji Guide](/@elisk/ji-guide) - A thorough guide on how to use Ji along with it's various features and functions - [Ji Starter](/@elisk/ji-starter) - Starter notebook that you can play with to get going with Ji in seconds - [Ji Lib — Collection](/collection/@elisk/ji-lib) - ObservableHQ collection of Ji vocabularies Join the Ji community on various social networks: (👷‍♂️ Under construction 👷‍♂️) - [JiBase — Github](https://www.github.com/jibase/) - [Jii — Reddit](https://www.reddit.com/r/Jii/) - [Ji — Facebook](https://www.facebook.com/groups/jilang) Other links: - Official website (☢️ 🔜 extremly under consutrction): [writeji.org](https://writeji.org/) - [Changelog](https://jilang-1.gitbook.io/docs/changelog) `32:[] 2f:{"title":"Ji Language","cells":[{"id":28,"value":"html`\n

${logo} Ji Language

\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":31,"value":"html`

⨎

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":9,"value":"md`\n## Introduction`","pinned":false,"hidden":false,"mode":"ojs"},{"id":13,"value":"$31","pinned":false,"hidden":false,"mode":"ojs"},{"id":50,"value":"md`## Getting Start with Ji\n\nJi begins simple - every character is a plain text characters. There are a few base symbols provided as the initial [*vocabulary*](/d/43cd2f6d8138b31d#vocabulary).\n\nThis implementation, here on ObservablesHQ, begins with a number of [basic sysmbols](/@elisk/ji#baseVocabulary) that allow you to start writing Ji code that can appear somewhat magical in cases.\n\nIt all starts with an \\`import\\` statement like so:\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":2,"value":"import { jit } from '@elisk/ji'","pinned":false,"hidden":false,"mode":"ojs"},{"id":470,"value":"md`And continues by using the \\`jit\\` function as a tagged template literal, like so:\n\n~~~js\njit\\`\n\nI write my Ji here!\n\n\\`\n~~~\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":54,"value":"md`Symbols in Ji can be one or more characters, and will receive a maximum of two arguments when invoked as functions; Left and Right.\n\nA ji symbol will take the left and right strings that surrounds it and will execute a given function or template when used in future code.\n\nBoth arguments are optional.\n\nLet's take a look at an example of Ji implemented in Observables - we'll be using the \\`jit\\` function which returns the Ji compiled string given to it as a \\`Markdown\\` element.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":109,"value":"jit`\n### Base Vocabulary\n\n† ⨕ () => ${['printVoca', printVoca]}()\n\n| Symbol | Code Point | Value |\n| ------ | ---------: | :---: |\n†\n\n\nSee default symbol documentation in [Ji source](/@elisk/ji#symbols).\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":173,"value":"jit`\n## Writing Ji\n\nJi is very much a plain text - if you're familiar with ObservablesHQ then you already know how to use \\`md\\` and \\`html\\` [tagged template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#Tagged_templates) - it's a plain markdown text.\n\nHere, take a look:\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":56,"value":"jit`\nHello, World!\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":63,"value":"md`Extremly underwhelming. Let's attempt at making this a little bit more... *computer programmingly*.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":182,"value":"jit`\nWe'll define 👋 as a string with the value 'Hello, World!';\n👋 ⨎ 'Hello, World!'\n\nAnd now we can just use the wave emoji to output \"👋\"\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":77,"value":"md`Let's attempt something a little bit more invigorating;`","pinned":false,"hidden":false,"mode":"ojs"},{"id":80,"value":"jit`\n📣 ⨎ (left, right) => {\n const num = parseInt(left)\n const output = []\n if (num > 0) {\n for (let i = 1; i <= num; ++i) {\n output.push(\\`\\${right === 'reverse' ? num - i : i}\\`)\n }\n }\n\n return '📣 ' + output.join(' ') + ' 📣 Ta Da!'\n}\n\n12📣\n\n\nOr we can count down, in reverse:\n\n20📣reverse\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":167,"value":"md`\n## ⨕
Word Symbol\n\nNow let's do something a bit more interactive...\n\nWe'll define ⁒ as a **Word Symbol** — Word Symbols will grab only the immidiate string to the left and right and not the entire line — that will do some basic maths for us, in this case calculating the percent of a given value:\n\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":372,"value":"jit`\n\n⁒ ⨕ (left, right) => {\n const nl = parseFloat(left)\n const nr = parseFloat(right)\n return nl + (nl * (nr / 100))\n}\n\nLet's say we want to calculate 320 + 20%, we could do this: 320⁒20\n\n\nhow about 320 - 20%? we could do this: 320⁒-20\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":383,"value":"md`## Imports\n\nThere are several ways to import code from elsewhere into your Ji code. In this implementation Ji utilizes the already powerful [import](https://observablehq.com/@observablehq/introduction-to-imports) & [require](https://observablehq.com/@observablehq/introduction-to-require) functionality built in Observable.\n\nBy binding Ji functions to Observable javascript functions we can acehieve some powerful results:\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":165,"value":"import { btcCalc, btcCalcSatoshi, btcCalcMilli } from '@elisk/jibc'","pinned":false,"hidden":false,"mode":"ojs"},{"id":216,"value":"jit`\n₿ ⨕ (left, right) => ${['calc', btcCalc]}(left, right)\n聡 ⨕ (left, right) => ${['calcSatoshi', btcCalcSatoshi]}(left, right)\nµ ⨕ (left, right) => ${['calcMilli', btcCalcMilli]}(left, right)\n\n\n1 btc = ₿ –, 512 BTC are: 512₿ —, $256 is: ₿256 —, $100,000 is: ₿100000 —.\n\n1 btc = ₿GBP –, 512 BTC are: 512₿GBP —, 256 GBP is: GBP₿256 —, 100,000 GBP is: GBP₿100000 —.\n\n1mbtc = µ —, 10 mbtc is 10µ —, 1 mbtc is 1µ —.\n\n1 Satoshi = 聡 —, 100 Satoshis are: 100聡 —, 50k Satoshis are: 50000聡 —, 1,500 Satoshis are: 1500聡 —, $800 in satoshis is: 聡800 —.\n\nAverage developer monthly salary in UK is ${`${Math.floor(43000 / 12)}`} GBP - that's: GBP聡3585 ,\nor GBP₿3585 .\n\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":426,"value":"md`

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":415,"value":"md`## ⨭
Import Symbol`","pinned":false,"hidden":false,"mode":"ojs"},{"id":395,"value":"md`\nAssigned imports are useful if you want to define your own symbols, but if you want to \"load\" already defined vocabulary, this might not be the best soltuion.\n\nJi output strings are smart and they can be \"imported\" into Ji code using the [Import Symbol](/@elisk/ji#symbols) (\"\\`⨭\\`\" by default).\n\nExample:\n\n~~~js\nimport { jit } from '@elisk/ji'\nimport { btc } from '@elisk/jibc'\n\njit\\`\n!⨭ \\${['btc', btc]}\n\\`\n~~~\n\nOutput:\n`\n","pinned":false,"hidden":false,"mode":"ojs"},{"id":408,"value":"jit`\n!⨭ ${['btc', btc]}\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":410,"value":"import { btc } from '@elisk/jibc'","pinned":false,"hidden":false,"mode":"ojs"},{"id":435,"value":"md`

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":437,"value":"html`

🏵

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":452,"value":"md`Learn more about Ji by looking at the [Ji source code](/@elisk/ji).\n\n### Examples\n\n- [Bitcoin Calculator](/@elisk/ji-bitcoin-calculator)\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":459,"value":"md`### Appendix`","pinned":false,"hidden":false,"mode":"ojs"},{"id":105,"value":"import { baseVoca } from '@elisk/ji'","pinned":false,"hidden":false,"mode":"ojs"},{"id":456,"value":"import { logo } from '@elisk/ji-assets'","pinned":false,"hidden":false,"mode":"ojs"},{"id":119,"value":"printVoca = () => `${Object.entries(baseVoca).map(([key, val]) => console.log('keyval', {key, val}) || `| ${key.replace(/\\s+/g, '')} | \\`${key.codePointAt(0)}\\` | ${val.length >= 1 && '👈' || ''}${val.length >= 2 && '👉' || ''} | - |`).join('\\n')}`","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W32","stdlib":"1","titling":"auto"}