Jos kirjoitat tietotekniikan tai muun teknisen tieteenalan tutkimuspaperia, voit halutessasi sisällyttää lähdekoodin tutkimuslähteisiisi, kuten GitHub -arkistosta löytyvän koodin. Yleensä sinun on sisällytettävä asiakirjan lopussa olevaan viittausluetteloon tarpeeksi tietoa, jotta lukijasi voi löytää koodin ja tarkistaa sen itse. Viittauksesi tietty muoto vaihtelee kuitenkin sen mukaan, mitä lainausopasta käytät. Tietotekniikassa yleisimmin käytetään sähkö- ja elektroniikkainsinöörien instituutti (IEEE), yhdistys laskennallisia koneita (ACM) ja neuvoston tiedetoimittajia (CSE).
Askeleet
Menetelmä 1/3: IEEE
Vaihe 1. Aloita syöttö koodin kirjoittajan nimellä
Jos kirjoittaja on yksityishenkilö, kirjoita sukunimi, sen jälkeen pilkku ja sitten ensimmäinen kirjain. Älä aseta pistettä alkukirjaimen jälkeen. Jos koodi on yrityksen tai laitoksen tuottama, käytä tätä nimeä tekijän nimenä.
- Esimerkki: Facebook
- Jos sinulla on vaikeuksia löytää GitHub -arkiston tekijää, katso tekijänoikeussivulta. Luettele tekijä, joka omistaa tekijänoikeudet.
Vaihe 2. Anna päivämäärä, jolloin koodi luotiin
Aseta päivämäärä suluissa kirjoittajan nimen jälkeen. Älä laita välimerkkejä sulkujen jälkeen. Käytä tekijänoikeuspäivää, jos et löydä tiettyä päivämäärää, jolloin koodi luotiin.
Esimerkki: Facebook (2020)
Vaihe 3. Sisällytä ohjelman nimi tai lähdekoodi ja tunnista tyyppi
Kirjoita ohjelman otsikko ReadMe -tiedostosta. Kopioi kirjainten käyttämät isot kirjaimet koodin tunnistamiseen, koska sillä voi olla merkitystä. Käytä kuvausta "Lähdekoodi" GitHub -arkistolle, hakasulkeissa. Aseta piste sulkevien hakasulkeiden jälkeen.
Esimerkki: Facebook (2020) Recoil [Lähdekoodi]
Vaihe 4. Sulje URL -osoite, josta koodi löytyy
GitHub -arkiston URL -osoite on arkiston perus -URL -osoite. Sulje merkintä asettamalla piste URL -osoitteen loppuun.
Esimerkki: Facebook (2020) Recoil [Lähdekoodi]
IEEE -viiteluettelomuoto:
AuthorLast, I (vuosi) Koodin nimi (versio #.) [Lähdekoodi]. URL -osoite.
Vaihe 5. Käytä hakasulkeita numeroita viitataksesi viiteluettelon kohtaan
Tekstissä olevat viittaukset eivät ole välttämättömiä IEEE-tyyliin. Katso sen sijaan lähdettä hakasulkeissa olevasta numerosta. Käytät samaa numeroa joka kerta, kun viittaat kyseiseen lähteeseen paperissasi.
Kun luot viiteluetteloa, luetteloi lähteet siinä järjestyksessä, jossa ne näkyvät paperissasi. Käytä samoja numeroita kuin paperissasi. Se voi auttaa pitämään luettelon lähteistä kirjoittaessasi, joten tiedät mikä lähde on liitetty mihin numeroon
Menetelmä 2/3: ACM
Vaihe 1. Aloita References -merkintäsi kirjoittajan nimellä
Kirjoita koodin kirjoittajan nimi etunimen ja sukunimen muodossa. Jos koodi tai arkisto on yrityksen tai laitoksen omistuksessa, sitä pidetään yleensä tekijänä.
Esimerkki: Hoanh An
Vaihe 2. Anna vuosi, jolloin arkisto luotiin
Jos et löydä tarkkaa vuotta, jolloin arkisto luotiin, käytä sen sijaan tekijänoikeusvuotta. Kirjoita tekijän jälkeinen vuosi ja sen jälkeen piste.
Esimerkki: Hoanh An. 2019
Vaihe 3. Lisää ohjelman nimi
Kirjoita ohjelman otsikko lauseessa, kirjoita isot kirjaimet ensimmäiseen sanaan ja mahdollisiin nimisanoihin. Jos tekstitys on olemassa, aseta kaksoispiste otsikon jälkeen ja kirjoita tekstitys lauseessa. Aseta piste loppuun.
Esimerkki: Hoanh An. 2019. Ultimate Go -opasopas
Vaihe 4. Sulje arkiston URL -osoite ja vuosi, jolloin käytit sitä
Kirjoita arkiston koko URL -osoite ja piste. Lisää sitten suluissa vuosi, jolloin käytit arkistoa. Aseta piste sulkevan sulun ulkopuolelle.
Esimerkki: Hoanh An. 2019. Ultimate Go -opasopas. https://github.com/hoanhan101/ultimate-go. (2020)
ACM -viittausten muoto:
Tekijä Ensimmäinen kirjoittaja Viimeinen. Vuosi. Ohjelman nimi. URL -osoite. (AccessYear).
Vaihe 5. Käytä hakasulkeissa olevaa numeroa tekstisisällölle
ACM -viitteet on lueteltu siinä järjestyksessä, johon ne viitataan paperissasi. Kirjoita jokaisen lauseen loppuun, jossa viitat koodiin, sarjanumero hakasulkeisiin. Käytä samaa numeroa kyseiselle lähteelle aina, kun viitat samaan koodiin.
Jos viittaat useisiin lähteisiin samassa lauseessa, lisää kaikki numerot samaan hakasulkeisiin pilkuilla erotettuna
Tapa 3/3: CSE
Vaihe 1. Aloita bibliografian merkintäsi tekijän nimellä
Kirjoita kirjoittajan sukunimi, sen jälkeen pilkku ja sitten kirjoittajan ensimmäinen kirjain. Jos sinulla on vaikeuksia löytää tekijää, katso tekijänoikeussivu - tekijänä pidetään henkilöä tai instituutiota, joka omistaa koodin oikeudet.
Esimerkki: Palmer, J
Vaihe 2. Lisää julkaisu- tai julkaisuvuosi
Julkaisu- tai julkaisuvuosi on yleensä lueteltu myös tekijänoikeussivulla. Kirjoita vuosi kirjoittajan nimen jälkeen ja aseta sitten piste vuoden jälkeen.
Esimerkki: Palmer, J. 2017
Vaihe 3. Sisällytä ohjelman tai arkiston nimi
Kirjoita otsikko lauseisiin, kirjoittamalla vain ensimmäinen sana ja mahdolliset substantiivit isolla alkukirjaimella. Jos otsikossa on koodi, kopioi otsikossa käytetyt isot kirjaimet. Jos haluat tekstityksen, aseta kaksoispiste otsikon perään ja kirjoita sitten tekstitys lauseessa. Sijoitti ajanjakson loppuun.
Esimerkki: Palmer, J. 2017. Formik: Rakenna lomakkeita Reactissa ilman kyyneliä
Vaihe 4. Anna julkaisijan sijainti ja nimi
GitHub -arkiston julkaisijana pidetään GitHubia, joka sijaitsee San Franciscossa Kaliforniassa. Kirjoita ensin kaupunki, jossa suluissa on valtion lyhenne "CA" ja sen jälkeen kaksoispiste. Kirjoita sitten julkaisijan nimi ja sen jälkeen puolipiste.
Esimerkki: Palmer, J. 2017. Formik: Rakenna lomakkeita Reactissa ilman kyyneliä. San Francisco (CA): GitHub;
Vaihe 5. Sulje käyttöpäiväsi ja URL -osoitteesi
Kirjoita hakasulkeisiin sana "accessed" ja lisää päivämäärä, jolloin viimeksi käytit koodia vuosi-kuukausi-päivä muodossa. Lyhennä kaikki kuukaudet 3 kirjaimeen. Aseta piste sulkeutuvan hakasulkeen jälkeen. Lisää arkiston URL -osoite ja aseta piste sen loppuun.
Esimerkki: Palmer, J. 2017. Formik: Rakenna lomakkeita Reactissa ilman kyyneliä. San Francisco (CA): GitHub; [katsottu 2020 16. toukokuuta]
CSE -bibliografinen muoto:
Kirjailija A. Vuosi. Ohjelman nimi. San Francisco (CA): GitHub; [käyty vuosi ma]. URL -osoite.
Vaihe 6. Mainitse lähteesi tekstin sisällä yhden kolmesta tekstin viittausjärjestelmästä
Vaikka useimmissa tyyli- ja muoto-oppaissa on yksi ensisijainen tapa viitata tekstissä, täsmähakukoneessa on kolme yhtä hyväksyttävää. Kumpaa käytät, riippuu ohjaajan tai neuvonantajan, akateemisen osaston tai julkaisun vaatimuksista. Valintasi ovat:
- Sitaatin nimi: Yläindeksinumerot tunnistavat tekstissä olevat viittaukset. Jokainen numero vastaa viitettä aakkosjärjestyksessä olevasta bibliografiastasi paperin lopussa.
- Lainausjärjestys: Yläindeksinumerot tunnistavat tekstissä olevat viittaukset. Kirjoituksesi lopussa oleva bibliografia on lueteltu siinä järjestyksessä, jossa viitteet näkyvät viitteinä.
- Nimi-vuosi: Käytä suluissa olevia tekstiviittauksia kirjoittajan nimen ja lähteen julkaisuvuoden kanssa. Kirjoituksesi lopussa oleva bibliografia on aakkosjärjestyksessä.