Si escriviu un article de recerca en informàtica o en una altra disciplina tècnica, és possible que vulgueu incloure el codi font a les fonts de recerca, com ara el codi que trobareu a un dipòsit de GitHub. En general, haureu d’incloure prou informació a la vostra llista de referències al final del vostre treball per permetre al vostre lector localitzar el codi i revisar-lo per si mateix. Tanmateix, el format específic de la vostra cita variarà en funció de la guia de citació que utilitzeu. A les ciències de la computació, s’utilitzen els estils de citació de l’Institut d’Enginyers Elèctrics i Electrònics (IEEE), Association for Computing Machinery (ACM) i Council of Science Editors (CSE).
Passos
Mètode 1 de 3: IEEE
Pas 1. Comenceu la vostra entrada amb el nom de l'autor del codi
Si l’autor és un individu, escriviu el seu cognom, seguit d’una coma i la primera inicial. No col·loqueu un punt després de la inicial. Si el codi el produeix una empresa o institució, utilitzeu aquest nom com a nom de l'autor.
- Exemple: Facebook
- Si teniu dificultats per trobar l'autor d'un dipòsit de GitHub, mireu a la pàgina de drets d'autor. Enumereu l’autor de l’entitat propietària dels drets d’autor.
Pas 2. Proporcioneu la data en què es va crear el codi
Col·loqueu la data entre parèntesis després del nom de l'autor. No col·loqueu cap puntuació després del parèntesi de tancament. Utilitzeu la data de copyright si no trobeu una data específica en què es va crear el codi.
Exemple: Facebook (2020)
Pas 3. Incloeu el títol del programa o el codi font i identifiqueu-ne el tipus
Escriviu el títol del programa des del fitxer ReadMe. Copieu les majúscules utilitzades pels autors per identificar el codi, ja que pot tenir significació. Utilitzeu la descripció "Codi font" per a un dipòsit de GitHub, entre claudàtors. Col·loqueu un punt després dels claudàtors de tancament.
Exemple: Facebook (2020) Recoil [codi font]
Pas 4. Tanqueu amb l'URL on es pot trobar el codi
Per a un dipòsit de GitHub, el vostre URL serà l'URL bàsic del dipòsit. Col·loqueu un punt al final de l'URL per tancar l'entrada.
Exemple: Facebook (2020) Recoil [codi font]
Format de llista de referència IEEE:
AuthorLast, I (Any) Title of Code (Version #. #) [Code source]. URL.
Pas 5. Utilitzeu un número entre claudàtors per referir-vos a l'entrada de la vostra llista de referències
Les citacions en text no són necessàries a l'estil IEEE. En lloc d’això, consulteu la font amb un número entre claudàtors. Fareu servir el mateix número cada vegada que feu referència a aquesta font al vostre document.
Quan creeu la llista de referències, indiqueu les fonts en l'ordre en què apareixen al paper, utilitzant els mateixos números que heu fet servir al paper. Pot ajudar-vos a mantenir una llista de fonts mentre escriviu, de manera que sabreu quina font s’adjunta a quin número
Mètode 2 de 3: ACM
Pas 1. Inicieu la vostra entrada de referències amb el nom de l'autor
Escriviu el nom de l'autor del codi en format de nom i cognom. Si el codi o el dipòsit és propietat d’una empresa o institució, aquesta empresa o institució se sol considerar l’autor.
Exemple: Hoanh An
Pas 2. Proporcioneu l'any en què es va crear el dipòsit
Si no trobeu un any exacte en què es va crear el dipòsit, feu servir l'any de copyright. Escriviu l'any després de l'autor, seguit d'un punt.
Exemple: Hoanh An. 2019
Pas 3. Afegiu el títol del programa
Escriviu el títol del programa entre majúscules i minúscules, posant en majúscula la primera paraula i els noms propis del títol. Si hi ha un subtítol, col·loqueu dos punts després del títol i escriviu el subtítol entre majúscules i minúscules. Posa un punt al final.
Exemple: Hoanh An. 2019. Guia d’estudi Ultimate Go
Pas 4. Tanca amb l'URL del dipòsit i l'any en què hi vas accedir
Escriviu l'URL complet del dipòsit, seguit d'un punt. A continuació, afegiu entre parèntesis l'any en què vau accedir al repositori. Col·loqueu un punt fora del parèntesi de tancament.
Exemple: Hoanh An. 2019. Guia d’estudi Ultimate Go. https://github.com/hoanhan101/ultimate-go. (2020)
Format de referències ACM:
Autor: primer autor. Curs. Títol del programa. URL. (AccessYear).
Pas 5. Utilitzeu un número entre claudàtors per a les vostres citacions de text
Les referències ACM s’enumeren en l’ordre en què es citen al vostre treball. Al final de qualsevol frase en què feu referència al codi, escriviu un número seqüencial entre claudàtors. Utilitzeu el mateix número per a aquesta font sempre que feu referència al mateix codi.
Si feu referència a diverses fonts en una mateixa frase, incloeu cadascun dels números en el mateix conjunt de claudàtors, separats per comes
Mètode 3 de 3: CSE
Pas 1. Comenceu la vostra entrada de bibliografia amb el nom de l'autor
Escriviu el cognom de l'autor, seguit d'una coma i, a continuació, la primera inicial de l'autor. Si teniu dificultats per trobar l’autor, mireu la pàgina de drets d’autor: la persona o la institució propietària dels drets del codi es considera l’autor.
Exemple: Palmer, J
Pas 2. Afegiu l'any de publicació o publicació
L'any de publicació o publicació normalment també apareix a la pàgina de drets d'autor. Escriviu l'any següent al nom de l'autor i, a continuació, col·loqueu un punt després de l'any.
Exemple: Palmer, J. 2017
Pas 3. Incloeu el títol del programa o dipòsit
Escriviu el títol entre majúscules i minúscules, posant en majúscules només la primera paraula i els noms propis. Si el títol conté codi, copieu les majúscules que s’utilitzen al títol. Per a un subtítol, col·loqueu dos punts després del títol i, a continuació, escriviu el subtítol entre majúscules i minúscules. Va col·locar un període al final.
Exemple: Palmer, J. 2017. Formik: Construeix formes a React, sense les llàgrimes
Pas 4. Proporcioneu la ubicació i el nom de l'editor
Per a un dipòsit de GitHub, GitHub, situat a San Francisco, Califòrnia, es considera l'editor. Escriviu primer la ciutat amb l'abreviatura estatal "CA" entre parèntesis, seguida de dos punts. A continuació, escriviu el nom de l'editor, seguit d'un punt i coma.
Exemple: Palmer, J. 2017. Formik: Construeix formes a React, sense les llàgrimes. San Francisco (CA): GitHub;
Pas 5. Tanqueu amb la vostra data d'accés i l'URL
Entre claudàtors, escriviu la paraula "accedit" i afegiu la data en què vau accedir al codi per última vegada en format any-mes-dia. Abrevieu tots els mesos a 3 lletres. Col·loqueu un punt després del claudàtor de tancament. Afegiu l'URL del dipòsit i, a continuació, col·loqueu un punt al final.
Exemple: Palmer, J. 2017. Formik: Construeix formes a React, sense les llàgrimes. San Francisco (CA): GitHub; [Consultat el 16 de maig de 2020]
Format de la bibliografia CSE:
Autor A. Any. Títol del programa. San Francisco (CA): GitHub; [Accedit a Year Mon Day]. URL.
Pas 6. Citeu les vostres fonts en text seguint 1 de 3 sistemes de citació en text
Tot i que la majoria de les guies d’estil i format tenen un mètode preferit de citació en text, CSE en té 3 que són igualment acceptables. El que utilitzeu depèn dels requisits del vostre instructor o assessor, departament acadèmic o publicació. Les vostres opcions són:
- Nom de la cita: els números de superíndex identifiquen les citacions del text. Cada número correspon a una referència de la vostra bibliografia alfabètica al final del treball.
- Seqüència de citacions: els números de superíndex identifiquen les citacions del text. La bibliografia al final del vostre treball s’enumera en l’ordre en què apareixen les referències com a cites al vostre treball.
- Any de nom: utilitzeu cites entre parèntesis amb el nom de l'autor i l'any de publicació de la font. La bibliografia al final del vostre treball està en ordre alfabètic.