diff options
Diffstat (limited to 'ms-my')
| -rw-r--r-- | ms-my/bash-my.html.markdown | 284 | ||||
| -rw-r--r-- | ms-my/clojure-my.html.markdown | 419 | ||||
| -rw-r--r-- | ms-my/sass-my.html.markdown | 232 | ||||
| -rw-r--r-- | ms-my/xml-my.html.markdown | 130 |
4 files changed, 1065 insertions, 0 deletions
diff --git a/ms-my/bash-my.html.markdown b/ms-my/bash-my.html.markdown new file mode 100644 index 00000000..e4e55b2c --- /dev/null +++ b/ms-my/bash-my.html.markdown @@ -0,0 +1,284 @@ +--- +category: tool +tool: bash +contributors: + - ["Max Yankov", "https://github.com/golergka"] + - ["Darren Lin", "https://github.com/CogBear"] + - ["Alexandre Medeiros", "http://alemedeiros.sdf.org"] + - ["Denis Arh", "https://github.com/darh"] + - ["akirahirose", "https://twitter.com/akirahirose"] + - ["Anton Strömkvist", "http://lutic.org/"] + - ["Rahil Momin", "https://github.com/iamrahil"] + - ["Gregrory Kielian", "https://github.com/gskielian"] + - ["Etan Reisner", "https://github.com/deryni"] +filename: LearnBash-ms.sh +translators: + - ["hack1m", "https://github.com/hack1m"] +lang: ms-my +--- + +Bash adalah nama daripada unix shell, yang mana telah diagihkan sebagai shell untuk sistem operasi GNU dan sebagai shell lalai pada Linux dan Mac OS X. Hampir semua contoh di bawah boleh menjadi sebahagian daripada skrip shell atau dijalankan terus dalam shell. + +[Baca lebih lanjut di sini.](http://www.gnu.org/software/bash/manual/bashref.html) + +```bash +#!/bin/bash +# Baris pertama daripada skrip ialah shebang yang mana memberitahu sistem bagaimana untuk melaksana +# skrip: http://en.wikipedia.org/wiki/Shebang_(Unix) +# Seperti yang anda sudah gambarkan, komen bermula dengan #. Shebang juga ialah komen. + +# Contoh mudah hello world: +echo Hello world! + +# Setiap arahan bermula pada baris baru, atau selepas semikolon: +echo 'This is the first line'; echo 'This is the second line' + +# Mengisytihar pembolehubah kelihatan seperti ini: +Variable="Some string" + +# Tetapi bukan seperti ini: +Variable = "Some string" +# Bash akan memutuskan yang pembolehubah adalah arahan ia mesti laksanakan dan memberi ralat +# kerana ia tidak boleh dijumpai. + +# Atau seperti ini: +Variable= 'Some string' +# Bash akan memutuskan yang ‘Beberapa rentetan’ adalah arahan ia mesti laksanakan dan memberi +# ralat kerana ia tidak dijumpai. (Dalam kes ini ‘Variable=' sebahagian dilihat +# sebagai penetapan pembolehubah sah hanya untuk skop ‘Beberapa rentetan’ +# arahan.) + +# Menggunakan pembolehubah: +echo $Variable +echo "$Variable" +echo '$Variable' +# Apabila anda guna pembolehubah itu sendiri - menetapkan, mengeksport, atau lain-lain - anda menulis +# nama ia tanpa $. Atau anda ingin menggunakan nilai pembolehubah, anda mesti guna $. +# Perlu diingatkan ‘(Petikan tunggal) tidak akan memperluaskan pembolehubah! + +# Penggantian rentetan dalam pembolehubah +echo ${Variable/Some/A} +# Ini akan menukarkan sebutan pertama bagi "Some" dengan "A" + +# Subrentetan daripada pembolehubah +Length=7 +echo ${Variable:0:Length} +# Ini akan kembalikan hanya 7 aksara pertama pada nilai + +# Nilai lalai untuk pembolehubah +echo ${Foo:-"DefaultValueIfFooIsMissingOrEmpty"} +# Ini berfungsi untuk null (Foo=) dan rentetan kosong (Foo=“”); sifar (Foo=0) kembali 0. +# Perlu diingatkan ia hanya kembalikan nilai lalai dan tidak mengubah nilai pembolehubah. + +# Pembolehubah terbina: +# Terdapat beberapa pembolehubah terbina berguna, seperti +echo "Last program's return value: $?" +echo "Script's PID: $$" +echo "Number of arguments passed to script: $#" +echo "All arguments passed to script: $@" +echo "Script's arguments separated into different variables: $1 $2..." + +# Membaca nilai dari input: +echo "What's your name?" +read Name # Perlu diingatkan kita tidak perlu isytihar pembolehubah baru +echo Hello, $Name! + +# Kita ada yang biasa jika struktur: +# guna 'man test' untuk maklumat lanjut tentang bersyarat +if [ $Name -ne $USER ] +then + echo "Your name isn't your username" +else + echo "Your name is your username" +fi + +# Terdapat juga pelaksanaan bersyarat +echo "Always executed" || echo "Only executed if first command fails" +echo "Always executed" && echo "Only executed if first command does NOT fail" + +# Untuk guna && dan || bersama kenyataan ‘if’, anda perlu beberapa pasang daripada tanda kurung siku: +if [ $Name == "Steve" ] && [ $Age -eq 15 ] +then + echo "This will run if $Name is Steve AND $Age is 15." +fi + +if [ $Name == "Daniya" ] || [ $Name == "Zach" ] +then + echo "This will run if $Name is Daniya OR Zach." +fi + +# Eskspresi ia ditandai dengan format berikut: +echo $(( 10 + 5 )) + +# Tidak seperti bahasa pengaturcaraan lain, bash adalah shell jadi ia berfungsi dalam konteks +# daripada direktori semasa. Anda boleh menyenaraikan fail dan direktori dalam direktori +# semasa dengan arahan ini: +ls + +# Arahan ini mempunyai opsyen yang mengawal perlaksanaannya: +ls -l # Senarai setiap fail dan direktori pada baris yang berbeza + +# Keputusan arahan sebelum boleh diberikan kepada arahan selepas sebagai input. +# arahan grep menapis input dengan memberi paten. Ini bagaimana kita boleh senaraikan +# fail .txt di dalam direktori semasa: +ls -l | grep "\.txt" + +# Anda boleh mengubah hala arahan input dan output (stdin, stdout, dan stderr). +# Baca dari stdin sampai ^EOF$ dan menulis ganti hello.py dengan baris +# antara “EOF": +cat > hello.py << EOF +#!/usr/bin/env python +from __future__ import print_function +import sys +print("#stdout", file=sys.stdout) +print("#stderr", file=sys.stderr) +for line in sys.stdin: + print(line, file=sys.stdout) +EOF + +# Jalankan hello.py dengan pelbagai penghantaran semula stdin, stdout, dan stderr: +python hello.py < "input.in" +python hello.py > "output.out" +python hello.py 2> "error.err" +python hello.py > "output-and-error.log" 2>&1 +python hello.py > /dev/null 2>&1 +# Output ralat akan menulis ganti fail jika ia wujud, +# jika anda ingin menambah sebaliknya, guna ‘>>”: +python hello.py >> "output.out" 2>> "error.err" + +# Menulis ganti output.out, menambah ke error.err, dan mengira baris: +info bash 'Basic Shell Features' 'Redirections' > output.out 2>> error.err +wc -l output.out error.err + +# Jalankan arahan dan cetak fail Deskriptor (e.g. /dev/fd/123) +# lihat: man fd +echo <(echo "#helloworld") + +# Menulis ganti output.out dengan “#helloworld": +cat > output.out <(echo "#helloworld") +echo "#helloworld" > output.out +echo "#helloworld" | cat > output.out +echo "#helloworld" | tee output.out >/dev/null + +# Membersihkan fail semantara keseluruhan (tambah ‘-i’ untuk interaktif) +rm -v output.out error.err output-and-error.log + +# Arahan boleh digantikan dalam arahan lain menggunakan $(): +# Arahan berikut memaparkan jumlah fail dan direktori dalam +# direktori semasa. +echo "There are $(ls | wc -l) items here." + +# Perkara yang sama boleh dilakukan dengan menggunakan backticks `` tetapi ia tidak boleh bersarang - cara yang terbaik +# ialah menggunakan $( ). +echo "There are `ls | wc -l` items here." + +# Bash menggunakan penyataan case yang berfungsi sama seperti ‘switch’ pada Java dan C++: +case "$Variable" in + # Senarai paten untuk syarat yang ada ingin ketemui + 0) echo "There is a zero.";; + 1) echo "There is a one.";; + *) echo "It is not null.";; +esac + +# ‘for loops iterate' untuk sebanyak mana argumen yang ditetapkan: +# Kandungan dari $Variable dicetakan sebanyak tiga kali. +for Variable in {1..3} +do + echo "$Variable" +done + +# Atau tulis ia cara "traditional for loop": +for ((a=1; a <= 3; a++)) +do + echo $a +done + +# Ia juga boleh digunakan untuk bertindak ke atas fail.. +# Ini akan menjalankan arahan 'cat' pada file1 dan file2 +for Variable in file1 file2 +do + cat "$Variable" +done + +# ..atau output daripada arahan +# Ini akan 'cat' output dari ls. +for Output in $(ls) +do + cat "$Output" +done + +# while loop: +while [ true ] +do + echo "loop body here..." + break +done + +# Anda juga boleh mendefinasikan fungsi +# Definasi: +function foo () +{ + echo "Arguments work just like script arguments: $@" + echo "And: $1 $2..." + echo "This is a function" + return 0 +} + +# atau lebih mudah +bar () +{ + echo "Another way to declare functions!" + return 0 +} + +# Memanggil fungsi +foo "My name is" $Name + +# Terdapat banyak arahan yang berguna yang perlu anda belajar: +# cetak 10 baris terakhir dalam file.txt +tail -n 10 file.txt +# cetak 10 baris pertama dalam file.txt +head -n 10 file.txt +# menyusun baris fail.txt +sort file.txt +# laporan atau meninggalkan garisan berulang, dengan -d ia melaporkan +uniq -d file.txt +# cetak hanya kolum pertama sebelum aksara ',' +cut -d ',' -f 1 file.txt +# menggantikan setiap kewujudan 'okay' dengan 'great' dalam file.txt, (serasi regex) +sed -i 's/okay/great/g' file.txt +# cetak ke stdoout semua baris dalam file.txt yang mana sepadan beberapa regex +# contoh cetak baris yang mana bermula dengan “foo” dan berakhir dengan “bar” +grep "^foo.*bar$" file.txt +# beri opsyen “-c” untuk sebaliknya mencetak jumlah baris sepadan regex +grep -c "^foo.*bar$" file.txt +# jika anda secara literal mahu untuk mencari rentetan, +# dan bukannya regex, guna fgrep (atau grep -F) +fgrep "^foo.*bar$" file.txt + + +# Baca dokumentasi Bash shell terbina dengan 'help' terbina: +help +help help +help for +help return +help source +help . + +# Baca dokumentasi Bash manpage dengan man +apropos bash +man 1 bash +man bash + +# Baca dokumentasi info dengan info (? for help) +apropos info | grep '^info.*(' +man info +info info +info 5 info + +# Baca dokumentasi bash info: +info bash +info bash 'Bash Features' +info bash 6 +info --apropos bash +``` diff --git a/ms-my/clojure-my.html.markdown b/ms-my/clojure-my.html.markdown new file mode 100644 index 00000000..e199c8f4 --- /dev/null +++ b/ms-my/clojure-my.html.markdown @@ -0,0 +1,419 @@ +--- +language: clojure +filename: learnclojure-ms.clj +contributors: + - ["Adam Bard", "http://adambard.com/"] +translators: + - ["Burhanuddin Baharuddin", "https://github.com/burhanloey"] +lang: ms-my +--- + +Clojure ialah salah satu bahasa pengaturcaraan dalam keluarga Lisp yang dibangunkan untuk Java Virtual Machine. Ia lebih +menekankan kepada konsep [functional programming](https://en.wikipedia.org/wiki/Functional_programming) jika dibandingkan +dengan Common Lisp, tetapi juga menyediakan kemudahan [STM](https://en.wikipedia.org/wiki/Software_transactional_memory) +untuk mengendalikan *state* apabila diperlukan. + +Gabungan tersebut membolehkan Clojure untuk mengendalikan beberapa proses serentak (*concurrency*) dengan mudah, +dan kebiasaannya secara automatik. + +(Anda perlukan Clojure versi 1.2 ke atas) + + +```clojure +; Komen bermula dengan koma bertitik (semicolon). + +; Clojure ditulis dalam bentuk yang seragam, iaitu +; senarai perkataan di dalam kurungan (parentheses), dipisahkan dengan ruang kosong (whitespace). +; +; Pembaca Clojure akan menganggap bahawa perkataan pertama dalam senarai tersebut +; sebagai `function` atau `macro` untuk digunakan, dan yang selebihnya sebagai arguments. + +; Panggilan pertama di dalam fail Clojure mestilah bermula dengan ns, untuk menentukan `namespace` +(ns learnclojure) + +; Contoh-contoh asas yang lain: + +; str akan mewujudkan sebuah string daripada beberapa `argument` +(str "Hello" " " "World") ; => "Hello World" + +; Operasi matematik pun mudah +(+ 1 1) ; => 2 +(- 2 1) ; => 1 +(* 1 2) ; => 2 +(/ 2 1) ; => 2 + +; Tanda = boleh digunakan untuk membuat perbandingan yang sama +(= 1 1) ; => true +(= 2 1) ; => false + +; Gunakan not untuk mengubah lojik +(not true) ; => false + +; Bentuk `nested` berfungsi seperti yang dijangkakan +(+ 1 (- 3 2)) ; = 1 + (3 - 2) => 2 + +; Type (Jenis Data) +;;;;;;;;;;;;; + +; Clojure menggunakan jenis `object` dari Java untuk `boolean`, `string` dan nombor. +; Gunakan `class` untuk memeriksa jenis sesebuah data. +(class 1) ; Secara default jenis data untuk `Integer` ialah java.lang.Long +(class 1.); Jenis data untuk Float pula ialah java.lang.Double +(class ""); `String` sentiasa berada dalam tanda petikan (quotation mark), dan merupakan java.lang.String +(class false) ; `Boolean` ialah java.lang.Boolean +(class nil); Nilai "null" dipanggil nil + +; Jika mahu membuat senarai data secara harfiah, gunakan ' untuk elakkan senarai tersebut +; daripada terus berfungsi +'(+ 1 2) ; => (+ 1 2) +; (singkatan untuk (quote (+ 1 2))) + +; Senarai data secara harfiah boleh berfungsi menggunakan eval +(eval '(+ 1 2)) ; => 3 + +; Collection & Sequence (Koleksi & Urutan) +;;;;;;;;;;;;;;;;;;; + +; `List` ialah struktur data `linked-list`, manakala `Vector` pula berasaskan `array`. +; `Vector` dan `List` juga merupakan class dari Java! +(class [1 2 3]); => clojure.lang.PersistentVector +(class '(1 2 3)); => clojure.lang.PersistentList + +; Sesebuah list boleh ditulis seperti (1 2 3), tetapi kita perlu meletakkan ' +; untuk mengelakkannya daripada berfungsi. +; Juga, (list 1 2 3) adalah sama dengan '(1 2 3) + +; "Collections" hanyalah kumpulan data +; Kedua-dua list dan vector ialah collection: +(coll? '(1 2 3)) ; => true +(coll? [1 2 3]) ; => true + +; "Sequences" (seq) ialah kriteria untuk sesebuah senarai data. +; Hanya list yang dikira sebagai seq. +(seq? '(1 2 3)) ; => true +(seq? [1 2 3]) ; => false + +; Sesebuah seq hanya perlukan satu kemasukan data untuk diakses. +; Jadi, seq yang boleh jadi `lazy` (malas) -- boleh menjadi tidak terkira (infinite): +(range 4) ; => (0 1 2 3) +(range) ; => (0 1 2 3 4 ...) (tiada penghujung) +(take 4 (range)) ; (0 1 2 3) + +; Gunakan cons untuk menambah sesuatu di awal sesebuah list atau vector +(cons 4 [1 2 3]) ; => (4 1 2 3) +(cons 4 '(1 2 3)) ; => (4 1 2 3) + +; Conj akan menambah sesuatu ke dalam collection dengan paling berkesan. +; Untuk list, data tersebut dimasukkan di permulaan. Untuk vector, dimasukkan di pengakhiran. +(conj [1 2 3] 4) ; => [1 2 3 4] +(conj '(1 2 3) 4) ; => (4 1 2 3) + +; Gunakan concat untuk menggabungkan list atau vector +(concat [1 2] '(3 4)) ; => (1 2 3 4) + +; Gunakan filter dan map untuk berinteraksi dengan data di dalam collection +(map inc [1 2 3]) ; => (2 3 4) +(filter even? [1 2 3]) ; => (2) + +; Gunakan reduce untuk dikecilkan (kepada satu nilai) +(reduce + [1 2 3 4]) +; = (+ (+ (+ 1 2) 3) 4) +; => 10 + +; Reduce boleh diberi nilai permulaan +(reduce conj [] '(3 2 1)) +; = (conj (conj (conj [] 3) 2) 1) +; => [3 2 1] + +; Function +;;;;;;;;;;;;;;;;;;;;; + +; Gunakan fn untuk membuat `function`. Sesebuah function pasti memulangkan semula +; hasil daripada barisan yang terakhir. +(fn [] "Hello World") ; => fn + +; (Anda perlukan satu lagi kurungan supaya function tersebut dikira) +((fn [] "Hello World")) ; => "Hello World" + +; Anda boleh membuat var menggunakan def +(def x 1) +x ; => 1 + +; Tetapkan sebuah function ke dalam var +(def hello-world (fn [] "Hello World")) +(hello-world) ; => "Hello World" + +; Proses di atas boleh diringkaskan menggunakan defn +(defn hello-world [] "Hello World") + +; Tanda [] merupakan senarai argument untuk function tersebut. +(defn hello [name] + (str "Hello " name)) +(hello "Steve") ; => "Hello Steve" + +; Cara ini juga boleh digunakan untuk membuat function dengan lebih ringkas: +(def hello2 #(str "Hello " %1)) +(hello2 "Fanny") ; => "Hello Fanny" + +; Anda juga boleh membuat satu function yang mempunyai beberapa bilangan argument +(defn hello3 + ([] "Hello World") + ([name] (str "Hello " name))) +(hello3 "Jake") ; => "Hello Jake" +(hello3) ; => "Hello World" + +; Function boleh diberi argument ekstra dalam bentuk seq +(defn count-args [& args] + (str "You passed " (count args) " args: " args)) +(count-args 1 2 3) ; => "You passed 3 args: (1 2 3)" + +; Anda boleh letakkan sekali argument biasa dan argument ekstra +(defn hello-count [name & args] + (str "Hello " name ", you passed " (count args) " extra args")) +(hello-count "Finn" 1 2 3) +; => "Hello Finn, you passed 3 extra args" + + +; Map +;;;;;;;;;; + +; Hash map dan array map menggunakan `interface` yang sama. Hash map lebih laju untuk diakses +; tetapi tidak mengekalkan urutan. +(class {:a 1 :b 2 :c 3}) ; => clojure.lang.PersistentArrayMap +(class (hash-map :a 1 :b 2 :c 3)) ; => clojure.lang.PersistentHashMap + +; Arraymap akan bertukar menjadi hashmap secara automatik untuk kebanyakan operasi +; apabila mereka menjadi semakin besar, jadi anda tidak perlu bimbang. + +; Map boleh menggunakan apa-apa sahaja jenis data sebagai key, tetapi kebiasaannya keyword adalah yang terbaik +; Keyword adalah sama seperti string cuma lebih efisyen +(class :a) ; => clojure.lang.Keyword + +(def stringmap {"a" 1, "b" 2, "c" 3}) +stringmap ; => {"a" 1, "b" 2, "c" 3} + +(def keymap {:a 1, :b 2, :c 3}) +keymap ; => {:a 1, :c 3, :b 2} + +; Oh, sebelum terlupa, tanda koma di atas hanya dianggap seperti whitespace, tak buat apa-apa. +; Dapatkan nilai daripada map dengan menggunakannya seperti function +(stringmap "a") ; => 1 +(keymap :a) ; => 1 + +; Keyword juga boleh digunakan untuk mendapatkan nilai daripada map tersebut! +(:b keymap) ; => 2 + +; Jangan cuba teknik di atas menggunakan string, tak jadi. +;("a" stringmap) +; => Exception: java.lang.String cannot be cast to clojure.lang.IFn + +; Apabila key yang digunakan tidak wujud, map akan memberi nil +(stringmap "d") ; => nil + +; Gunakan assoc untuk menambah key yang baru ke dalam hash-map +(def newkeymap (assoc keymap :d 4)) +newkeymap ; => {:a 1, :b 2, :c 3, :d 4} + +; Tetapi ingat, data dalam clojure adalah `immutable` (tidak berubah)! +keymap ; => {:a 1, :b 2, :c 3} + +; Gunakan dissoc untuk membuang key +(dissoc keymap :a :b) ; => {:c 3} + +; Set +;;;;;; + +(class #{1 2 3}) ; => clojure.lang.PersistentHashSet +(set [1 2 3 1 2 3 3 2 1 3 2 1]) ; => #{1 2 3} + +; Tambah data menggunakan conj +(conj #{1 2 3} 4) ; => #{1 2 3 4} + +; Buang data menggunakan disj +(disj #{1 2 3} 1) ; => #{2 3} + +; Periksa kewujudan data dengan menggunakan set tersebut sebagai function: +(#{1 2 3} 1) ; => 1 +(#{1 2 3} 4) ; => nil + +; Ada pelbagai lagi function untuk set di namespace clojure.sets. + +; Form yang berguna +;;;;;;;;;;;;;;;;; + +; Lojik dalam clojure hanyalah sebuah macro, dan kelihatan seperti +; yang lain +(if false "a" "b") ; => "b" +(if false "a") ; => nil + +; Gunakan let untuk membuat binding sementara +(let [a 1 b 2] + (> a b)) ; => false + +; Kumpulkan beberapa statement sekali menggunakan do +(do + (print "Hello") + "World") ; => "World" (prints "Hello") + +; Function sebenarnya ada do secara tersirat +(defn print-and-say-hello [name] + (print "Saying hello to " name) + (str "Hello " name)) +(print-and-say-hello "Jeff") ;=> "Hello Jeff" (prints "Saying hello to Jeff") + +; Let pun sama +(let [name "Urkel"] + (print "Saying hello to " name) + (str "Hello " name)) ; => "Hello Urkel" (prints "Saying hello to Urkel") + + +; Gunakan `threading macro` (-> dan ->>) untuk menulis penggubahan data +; dengan lebih jelas. + +; Macro "thread-first" (->) memasukkan hasil perkiraan ke setiap form +; yang selepasnya, sebagai argument pertama (item yang kedua) +(-> + {:a 1 :b 2} + (assoc :c 3) ;=> (assoc {:a 1 :b 2} :c 3) + (dissoc :b)) ;=> (dissoc (assoc {:a 1 :b 2} :c 3) :b) + +; Code di atas boleh ditulis seperti ini: +; (dissoc (assoc {:a 1 :b 2} :c 3) :b) +; dan hasilnya ialah {:a 1 :c 3} + +; Yang dua anak panah pula membuat benda yang sama, tetapi memasukkan hasil perkiraan +; setiap baris ke pengakhiran form selepasnya. Cara ini berguna untuk operasi +; yang melibatkan collection: +(->> + (range 10) + (map inc) ;=> (map inc (range 10) + (filter odd?) ;=> (filter odd? (map inc (range 10)) + (into [])) ;=> (into [] (filter odd? (map inc (range 10))) + ; Result: [1 3 5 7 9] + +; Jika anda mahu lebih fleksibel untuk meletakkan hasil perkiraan, +; anda boleh menggunakan macro `as->`. Dengan menggunakan macro tersebut, +; anda boleh menentukan nama untuk output dan menggunakannya semula +; ke dalam operasi berangkai: + +(as-> [1 2 3] input + (map inc input);=> You can use last transform's output at the last position + (nth input 2) ;=> and at the second position, in the same expression + (conj [4 5 6] input [8 9 10])) ;=> or in the middle ! + + + +; Module +;;;;;;;;;;;;;;; + +; Gunakan "use" untuk mendapatkan semua function daripada sesebuah module +(use 'clojure.set) + +; Sekarang kita boleh menggunakan operasi untuk set +(intersection #{1 2 3} #{2 3 4}) ; => #{2 3} +(difference #{1 2 3} #{2 3 4}) ; => #{1} + +; Anda juga boleh memilih sebahagian daripada function untuk diimport +(use '[clojure.set :only [intersection]]) + +; Gunakan require untuk mengimport sesebuah module +(require 'clojure.string) + +; Gunakan / untuk menggunakan function daripada module +; Di sini, nama module tersebut ialah clojure.string dan function-nya ialah blank? +(clojure.string/blank? "") ; => true + +; Anda juga boleh memberi nama yang lebih ringkas untuk module semasa import +(require '[clojure.string :as str]) +(str/replace "This is a test." #"[a-o]" str/upper-case) ; => "THIs Is A tEst." +; (#"" ialah ungkapan untuk regular expression, regex) + +; Anda boleh menggunakan require (dan use, tetapi elakkan) daripada namespace menggunakan :require. +; Anda tidak perlu menulis semula nama module dengan cara ini. +(ns test + (:require + [clojure.string :as str] + [clojure.set :as set])) + +; Java +;;;;;;;;;;;;;;;;; + +; Java mengandungi banyak standard library yang kita boleh manfaatkan, jadi +; anda patut tahu bagaimana untuk menggunakannya. + +; Gunakan import untuk load module java +(import java.util.Date) + +; Anda juga boleh import menggunakan ns. +(ns test + (:import java.util.Date + java.util.Calendar)) + +; Gunakan nama class berserta "." di hujungnya untuk membuat object baru +(Date.) ; <object date> + +; Gunakan . untuk menggunakan method. Atau gunakan shortcut seperti ".method" +(. (Date.) getTime) ; <sebuah timestamp> +(.getTime (Date.)) ; sama sahaja. + +; Gunakan / untuk menggunakan static method +(System/currentTimeMillis) ; <sebuah timestamp> (System sentiasa wujud dalam Java) + +; Gunakan doto untuk menjadikan proses yang melibatkan class mutable (boleh berubah) lebih mudah +(import java.util.Calendar) +(doto (Calendar/getInstance) + (.set 2000 1 1 0 0 0) + .getTime) ; => Sebuah Date. yang ditetapkan kepada 2000-01-01 00:00:00 + +; STM +;;;;;;;;;;;;;;;;; + +; Software Transactional Memory ialah mekanisme dalam Clojure untuk mengendalikan +; state yang kekal berterusan. Ada beberapa kaedah dalam Clojure yang menggunakan teknik tersebut. + +; Atom adalah yang paling mudah. Letakkannya sewaktu meletakkan nilai permulaan. +(def my-atom (atom {})) + +; Kemas kini sebuah atom menggunakan swap!. +; swap! mengambil satu function dan menggunakannya menggunakan nilai asal atom +; sebagai argument pertama, dan argument selebihnya sebagai argument kedua +(swap! my-atom assoc :a 1) ; Tetapkan my-atom kepada hasil perkiraan (assoc {} :a 1) +(swap! my-atom assoc :b 2) ; Tetapkan my-atom kepada hasil perkiraan (assoc {:a 1} :b 2) + +; Gunakan '@' untuk mendapatkan nilai daripada atom +my-atom ;=> Atom<#...> (memberi object atom itu sendiri) +@my-atom ; => {:a 1 :b 2} + +; Ini adalah contoh untuk mengira menggunakan atom +(def counter (atom 0)) +(defn inc-counter [] + (swap! counter inc)) + +(inc-counter) +(inc-counter) +(inc-counter) +(inc-counter) +(inc-counter) + +@counter ; => 5 + +; Kaedah lain yang menggunakan STM ialah ref dan agent. +; Ref: http://clojure.org/refs +; Agent: http://clojure.org/agents +``` + +### Bacaan Lanjut + +Ini masih belum lengkap, tetapi harap-harap cukup untuk membuatkan anda lebih bersedia. + +Clojure.org mempunyai banyak artikel: +[http://clojure.org/](http://clojure.org/) + +Clojuredocs.org mempunyai dokumentasi berserta contoh untuk menggunakan kebanyakan function teras: +[http://clojuredocs.org/quickref/Clojure%20Core](http://clojuredocs.org/quickref/Clojure%20Core) + +4Clojure ialah cara yang baik untuk mengasah skill Clojure dan functional programming: +[http://www.4clojure.com/](http://www.4clojure.com/) + +Clojure-doc.org (yup, serius) juga mengandungi beberapa artikel sebagai permulaan: +[http://clojure-doc.org/](http://clojure-doc.org/) diff --git a/ms-my/sass-my.html.markdown b/ms-my/sass-my.html.markdown new file mode 100644 index 00000000..68ce4ab3 --- /dev/null +++ b/ms-my/sass-my.html.markdown @@ -0,0 +1,232 @@ +--- +language: sass +filename: learnsass-ms.scss +contributors: + - ["Laura Kyle", "https://github.com/LauraNK"] +translators: + - ["hack1m", "https://github.com/hack1m"] +lang: ms-my +--- + +Sass ialah bahasa sambungan CSS yang menambah ciri-ciri seperti pembolehubah, bersarang, mixins dan banyak lagi. +Sass (dan prapemproses lain, seperti [Less](http://lesscss.org/)) membantu pembangun untuk menulis kod mampu diselenggara dan DRY (Don't Repeat Yourself). + +Sass mempunyai dua perbezaan pilihan sintaks untuk dipilih. SCSS, yang mana mempunyai sintaks yang sama seperti CSS tetapi dengan ditambah ciri-ciri Sass. Atau Sass (sintaks asal), yang menggunakan indentasi bukannya tanda kurung dakap dan semikolon. +Tutorial ini ditulis menggunakan SCSS. + +```scss + +//Komen baris tunggal dikeluarkan apabila Sass dikompil ke CSS. + +/*Komen multi dikekalkan. */ + + + +/*Pembolehubah +==============================*/ + + + +/* Anda boleh menyimpan nilai CSS (seperti warna) dalam pembolehubah. +Guna simbol '$' untuk membuat pembolehubah. */ + +$primary-color: #A3A4FF; +$secondary-color: #51527F; +$body-font: 'Roboto', sans-serif; + +/* Anda boleh mengguna pembolehubah diseluruh lembaran gaya anda. +Kini jika anda ingin mengubah warna, anda hanya perlu membuat perubahan sekali.*/ + +body { + background-color: $primary-color; + color: $secondary-color; + font-family: $body-font; +} + +/* Ia akan dikompil kepada: */ +body { + background-color: #A3A4FF; + color: #51527F; + font-family: 'Roboto', sans-serif; +} + + +/* Ini jauh lebih mampu diselenggara daripada perlu menukar warna +setiap yang ada diseluruh lembaran gaya anda. */ + + + +/*Mixins +==============================*/ + + + +/* Jika anda jumpa yang anda menulis kod yang sama pada lebih dari satu +elemen, anda mungkin ingin menyimpan kod itu di dalam mixin. + +Guna arahan '@mixin', tambah dengan nama untuk mixin anda.*/ + +@mixin center { + display: block; + margin-left: auto; + margin-right: auto; + left: 0; + right: 0; +} + +/* Anda boleh guna mixin bersama '@include' dan nama mixin. */ + +div { + @include center; + background-color: $primary-color; +} + +/*Ia akan dikompil kepada: */ +div { + display: block; + margin-left: auto; + margin-right: auto; + left: 0; + right: 0; + background-color: #A3A4FF; +} + + +/* Anda boleh guna mixins untuk membuat singkatan property. */ + +@mixin size($width, $height) { + width: $width; + height: $height; +} + +/*Yang mana anda boleh seru dengan memberi argumen lebar dan tinggi. */ + +.rectangle { + @include size(100px, 60px); +} + +.square { + @include size(40px, 40px); +} + +/* Ia dikompil kepada: */ +.rectangle { + width: 100px; + height: 60px; +} + +.square { + width: 40px; + height: 40px; +} + + + + +/*Extend (Inheritance) +==============================*/ + + + +/*Extend ialah jalan untuk berkongsi sifat dengan satu pemilih dengan yang lain. */ + +.display { + @include size(5em, 5em); + border: 5px solid $secondary-color; +} + +.display-success { + @extend .display; + border-color: #22df56; +} + +/* Dikompil kepada: */ +.display, .display-success { + width: 5em; + height: 5em; + border: 5px solid #51527F; +} + +.display-success { + border-color: #22df56; +} + + + + +/*Bersarang +==============================*/ + + + +/*Sass membenarkan anda untuk sarangkan pemilih dengan pemilih */ + +ul { + list-style-type: none; + margin-top: 2em; + + li { + background-color: #FF0000; + } +} + +/* '&' akan digantikan dengan pemilih induk. */ +/* Anda juga boleh sarangkan kelas-pseudo. */ +/* Perlu diingat terlebih bersarang akan membuat kod anda kurang mampu diselenggara. +Sebagai contoh: */ + +ul { + list-style-type: none; + margin-top: 2em; + + li { + background-color: red; + + &:hover { + background-color: blue; + } + + a { + color: white; + } + } +} + +/* Dikompil kepada: */ + +ul { + list-style-type: none; + margin-top: 2em; +} + +ul li { + background-color: red; +} + +ul li:hover { + background-color: blue; +} + +ul li a { + color: white; +} + + + + +``` + + + +## SASS atau Sass? +Adakah anda tertanya-tanya sama ada Sass adalah akronim atau tidak? Anda mungkin tidak perlu, tetapi saya akan memberitahu. Nama bahasa ini adalah perkataan, "Sass", dan tidak akronim. +Kerana orang sentiasa menulis ia sebagai "Sass", pencipta bahasa bergurau memanggilnya "Syntactically Awesome StyleSheets". + +## Berlatih Sass +Jika anda ingin bermain dengan Sass di pelayar anda, lihat [SassMeister](http://sassmeister.com/). +Anda boleh guna salah satu sintaks, hanya pergi ke tetapan dan pilih sama ada Sass atau SCSS. + + +## Bacaan lanjut +* [Dokumentasi Rasmi](http://sass-lang.com/documentation/file.SASS_REFERENCE.html) +* [The Sass Way](http://thesassway.com/) menyediakan tutorial (asas-lanjutan) dan artikel. diff --git a/ms-my/xml-my.html.markdown b/ms-my/xml-my.html.markdown new file mode 100644 index 00000000..a9d7509b --- /dev/null +++ b/ms-my/xml-my.html.markdown @@ -0,0 +1,130 @@ +--- +language: xml +filename: learnxml-ms.xml +contributors: + - ["João Farias", "https://github.com/JoaoGFarias"] +translators: + - ["hack1m", "https://github.com/hack1m"] +lang: ms-my +--- + +XML adalah bahasa markup direka untuk menyimpan dan mengangkutan data. + +Tidak seperti HTML, XML tidak menyatakan bagaimana paparan atau mengformat data, hanya membawanya. + +* Sintaks XML + +```xml +<!-- Komen di XML seperti ini --> + +<?xml version="1.0" encoding="UTF-8"?> +<bookstore> + <book category="COOKING"> + <title lang="en">Everyday Italian</title> + <author>Giada De Laurentiis</author> + <year>2005</year> + <price>30.00</price> + </book> + <book category="CHILDREN"> + <title lang="en">Harry Potter</title> + <author>J K. Rowling</author> + <year>2005</year> + <price>29.99</price> + </book> + <book category="WEB"> + <title lang="en">Learning XML</title> + <author>Erik T. Ray</author> + <year>2003</year> + <price>39.95</price> + </book> +</bookstore> + +<!-- Di atas adalah fail XML biasa. + Ia bermula dengan perisytiharan, memaklumkan beberapa metadata (pilihan). + + XML menggunakan struktur pokok, Di atas, nod akar ialah ‘bookstore’, yang mana mempunyai tiga nod anak, semua ‘books’. Nod itu mempunyai lebih nod anak (atau anak-anak), dan seterusnya… + + Nod dibuat menggunakan tag pembuka/penutup, dan anak-anak hanya nod antara + pembuka dan penutup tag.--> + + + <!-- XML membawa dua jenis data: + 1 - Atribut -> Iaitu metadata mengenai nod. + Biasanya, penghurai XML menggunakan informasi untuk menyimpan data dengan betul. + Ia mempunyai ciri-ciri yang dipaparkan bersama format name=“value” dalam tag + pembuka. + + 2 - Elemen -> Iaitu data tulen. + Iaitu apa penghurai akan menerima daripada fail XML. + Elemen memaparkan diantara pembuka dan penutup tag. —> + + +<!-- Di bawah, elemen dengan dua atribut --> +<file type="gif" id="4293">computer.gif</file> + + +``` + +* Dokumen Format sempurna x Pengesahan + +Satu dokumen XML adalah format sempurna jika ia adalah sintaksis yang betul. +Walau bagaimanapun, ia mungkin menyuntik lebih banyak kekangan dalam dokumen itu, +menggunakan definasi dokumen, seperti DTD dan Skema XML. + +Satu dokumen XML yang mana mengikut definasi dokumen dipanggil sah, +mengenai dokumen itu. + +Dengan alat ini, anda boleh menyemak data XML di luar logik aplikasi. + +```xml + +<!-- Dibawah, anda boleh melihat versi ringkas daripada dokumen bookstore, + dengan tambahan definisi DTD. --> + +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE note SYSTEM "Bookstore.dtd"> +<bookstore> + <book category="COOKING"> + <title >Everyday Italian</title> + <price>30.00</price> + </book> +</bookstore> + +<!-- DTD boleh menjadi sesuatu seperti ini: --> + +<!DOCTYPE note +[ +<!ELEMENT bookstore (book+)> +<!ELEMENT book (title,price)> +<!ATTLIST book category CDATA "Literature"> +<!ELEMENT title (#PCDATA)> +<!ELEMENT price (#PCDATA)> +]> + + +<!-- DTD bermula dengan pengisytiharan. + Berikut, nod akar diisytihar, memerlukan 1 atau lebih nod anak ‘book’. + Setiap ‘book’ harus mengandungi betul-betul satu ‘title’ dan ‘price’ dan atribut + dipanggil ‘category’, bersama “Literature" sebagai nilai lalai ia. + Nod ‘title’ dan ‘price’ mengandungi aksara data terhurai.-—> + +<!-- DTD boleh diisytiharkan di dalam fail XML itu sendiri. --> + +<?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE note +[ +<!ELEMENT bookstore (book+)> +<!ELEMENT book (title,price)> +<!ATTLIST book category CDATA "Literature"> +<!ELEMENT title (#PCDATA)> +<!ELEMENT price (#PCDATA)> +]> + +<bookstore> + <book category="COOKING"> + <title >Everyday Italian</title> + <price>30.00</price> + </book> +</bookstore> +``` |