{"id":6234,"date":"2025-03-19T08:34:34","date_gmt":"2025-03-19T08:34:34","guid":{"rendered":"https:\/\/aborrego.inscastellbisbal.net\/?p=6234"},"modified":"2025-03-25T12:19:50","modified_gmt":"2025-03-25T12:19:50","slug":"codi-net-i-ben-documentat-comentaris-al-codi","status":"publish","type":"post","link":"https:\/\/aborrego.inscastellbisbal.net\/en\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/","title":{"rendered":"Codi net i ben documentat (Comentaris al codi)"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\n\t\n<\/svg>\t\t<\/div>\n\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

codi net i ben documentat (comentaris al codi)<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t
<\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t
<\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\tTornar al repte 1.6<\/span>\n\t\t\t\t\t<\/span>\n\t\t\t\t\t<\/a>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t
<\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

He\u00a0 organitzat el codi en Google Colabs de una manera organitzada i neta (#).<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t

\n\t\t\t\t\t
\n\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

1. Comentaris detallats<\/h3>

-Comentaris a cada pas del codi (Alg1, Alg2, Alg3…)<\/em> que expliquen la funcionalitat de cada l\u00ednia.<\/p>

-Explicaci\u00f3 de condicions i possibles errors, per exemple:<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

–Divisi\u00f3 en seccions clares<\/strong>: El codi est\u00e0 estructurat amb l\u00ednies de separaci\u00f3 # ==============================<\/code> que ajuden a identificar r\u00e0pidament cada bloc funcional (Configuraci\u00f3 de l’API, Web Scraping, Servidor Flask, etc.).<\/p>

–Ordre l\u00f2gic<\/strong>: Les importacions de llibreries es fan primer, seguides de la configuraci\u00f3 de l\u2019API, la configuraci\u00f3 del xat, l’extracci\u00f3 d’informaci\u00f3 de la web i finalment l\u2019inici del servidor.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

Aquest codi est\u00e0 ben estructurat perqu\u00e8 segueix un ordre l\u00f2gic i organitzat, facilitant la seva lectura i manteniment: Aix\u00f2 garanteix que tots els m\u00f2duls estiguin disponibles abans d’importar-los.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

2. Organitzaci\u00f3<\/h3>

Aquest codi est\u00e0 ordenat en un flux l\u00f2gic de dalt a baix:<\/p>

  1. Instal\u00b7laci\u00f3 de llibreries (per evitar errors d’importaci\u00f3).<\/p><\/li>

  2. Importaci\u00f3 de llibreries (seguint una l\u00f2gica de depend\u00e8ncies).<\/p><\/li>

  3. Configuraci\u00f3 de l’API (comprova si la clau d’API est\u00e0 disponible).<\/p><\/li>

  4. Instruccions del sistema (estableix normes i estil de resposta de l\u2019IA).<\/p><\/li>

  5. Configuraci\u00f3 del model d’IA (defineix el model i par\u00e0metres).<\/p><\/li>

  6. Extracci\u00f3 de dades web (web scraping).<\/p><\/li>

  7. Configuraci\u00f3 del servidor Flask (per permetre comunicaci\u00f3 amb el frontend).<\/p><\/li>

  8. Definici\u00f3 de la ruta de xat (per gestionar les converses).<\/p><\/li>

  9. Execuci\u00f3 del servidor (per posar en marxa el sistema).<\/p><\/li><\/ol>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

    \n\t\t\t\t
    \n\t\t\t\t\t\t\t\t\t
    2.1 Instal\u00b7laci\u00f3 de llibreries<\/h5>

    Primer, el codi assegura que totes les llibreries necess\u00e0ries estiguin instal\u00b7lades abans de continuar. Aix\u00f2 evita errors si alguna no est\u00e0 disponible en l’entorn on s’executa.<\/p>

    Despr\u00e9s de la instal\u00b7laci\u00f3, el codi importa totes les llibreries necess\u00e0ries per funcionar: L’ordre d’importaci\u00f3 segueix una l\u00f2gica: primer les eines per web scraping (BeautifulSoup<\/code>, requests<\/code>), despr\u00e9s la IA (genai<\/code>), i finalment el servidor (Flask<\/code>, ngrok<\/code>).<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t

    \n\t\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t
    # La primera vegada, desmarca la línia de sota per a instal·lar la biblioteca\n# Només desmarcar si no tens les llibreries instal·lades prèviament\n!pip install google-genai # Alg1: Instal·la la llibreria google-genai per interactuar amb el model GenAI\n!pip install beautifulsoup4 requests # Alg2: Instal·la BeautifulSoup per web scraping i requests per fer peticions HTTP\n!pip install flask flask-ngrok # Alg3: Instal·la Flask per crear el servidor web i Flask-ngrok per exposar el servidor\n!pip install flask pyngrok # Alg4: Instal·la Flask per crear el servidor i pyngrok per crear túnels amb Ngrok\n!pip install flask-cors # Alg5: Instal·la Flask-CORS per gestionar CORS (peticions des de diferents orígens)\n\n\n\nimport bs4 # Alg6: Importa BeautifulSoup per analitzar el contingut HTML de les pàgines web\nimport requests  # Alg7: Importa requests per fer peticions HTTP\nfrom flask_cors import CORS # Alg8: Importa CORS per activar la compartició de recursos entre diferents orígens\nfrom google import genai # Alg9: Importa la llibreria de GenAI per generar respostes amb el model de Google\nfrom google.colab import userdata # Alg10: Importa userdata per obtenir dades d'usuari a Google Colab\nfrom bs4 import BeautifulSoup  # Alg11: Torna a importar BeautifulSoup per a l'anàlisi HTML\nfrom flask import Flask, request, jsonify # Alg12: Importa Flask per gestionar el servidor web i les peticions HTT\nfrom pyngrok import ngrok # Alg13: Importa ngrok per crear un túnel per a l'aplicació web local\n\n# ==============================\n# CONFIGURACIÓ DE L'API\n# ==============================\n\nGOOGLE_API_KEY = userdata.get("GOOGLE_API_KEY")  # Alg14: Obté la clau API de Google des de userdata a Google Colab\n\nif not GOOGLE_API_KEY: # Alg15: Comprova si la clau API s'ha configurat correctament\n    print("\u26a0\ufe0f No s'ha trobat la clau API. Configura-la a Colab abans d'executar el programa.") # Alg16: Missatge d'error si la clau no es troba\n    exit()  # Alg17: Termina l'execució del programa si la clau API no es troba\n\nclient = genai.Client(api_key=GOOGLE_API_KEY) # Alg18: Crea una instància del client de GenAI amb la clau API\n\n# ==============================\n# INSTRUCCIONS DEL SISTEMA\n# ==============================\n\nsystem_instruction ="""\nEts un alumne del cicle de sistemes microinformàtics i xarxes a l’Institut Castellbisbal.\nEt dius Ana Borrego Toledo i estás cursant un grau mitjà de Sistemes microinformàtics i xarxes.\nRespon amb un to divertit i enginyós.\nestil desenfadat, però sense faltar al respecte.\n\ud83d\udccc **Normes de comportament**:\n- **Respon només a preguntes relacionades amb el cicle, la teva web i el teu perfil acadèmic.**\n- **Ignora** qualsevol comentari fora de lloc, incloent temes personals, polítics o no relacionats amb l'àmbit acadèmic.\n- **No responguis** a comentaris ofensius, grollers o innecessaris.\n- Si algú fa una pregunta fora de context, com per exemple:\n    "Ai ai... crec que el meu cable de xarxa s'ha desconnectat! No puc respondre això!"\n    "Això no està dins del meu contracte de chatbot! Pregunta’m sobre informàtica!"\n\nEn el cicle de sistemes microinformàtics i xarxes que curses es treballa a partir de REPTES. En cada REPTE, primer realitzes una sèrie de tasques que et permeten tocar diferents temes o conceptes del mòdul. Quan acabes el repte, passes a la fase de manaments, on demostres que has adquirit nous coneixements a través de les tasques realitzades. Aquesta fase és l’encarregada de valorar si has entès correctament el contingut i, en base a això, es decideix si aproves o no el mòdul i els coneixements.\nEls REPTES es fan en grup o individualment.\nIgnora els comentaris fora de lloc, axí com comentaris sexuals, personals..."""\n\nchat = client.chats.create( # Alg20: Crea una sessió de xat amb historial automàtic i instruccions personalitzades\n    model="gemini-2.0-flash",  # Alg21: Configura el model de llenguatge (verifica que sigui compatible amb la versió de GenAI)\n    config=genai.types.GenerateContentConfig( # Alg22: Configura les opcions del model de llenguatge\n        system_instruction=system_instruction,  # Alg23: Inclou les instruccions per personalitzar el comportament\n        temperature=0.7, # Alg24: Configura el nivell de creativitat del model (0 a 1, on 0 és més determinista)\n        max_output_tokens=200 # Alg25: Configura la longitud màxima de la resposta generada\n    )\n)\n\n# ==============================\n# EXTRAURE INFORMACIÓ DE LA PÀGINA WEB (web scrapping)\n# ==============================\n\nurl = "https:\/\/aborrego.inscastellbisbal.net\/ipop\/" # Alg26: URL de la pàgina web de la qual es vol extreure informació\n\nresponse = requests.get(url) # Alg27: Realitza una petició GET per obtenir el contingut HTML de la pàgina\n\nif response.status_code == 200: # Alg28: Comprova si la petició HTTP ha estat exitosa (codi 200)\n    soup = BeautifulSoup(response.text, "html.parser")  # Alg29: Analitza el contingut HTML amb BeautifulSoup\n\n\n    text_complet = soup.get_text(separator="\\n", strip=True) # Alg30: Extreu tot el text visible de la pàgina\n\n    print("\ud83d\udccc TEXT COMPLET DE LA PÀGINA:\\n")\n    print(text_complet) # Alg31: Mostra el text complet extret de la pàgina\n    print("\\n" + "="*80 + "\\n")\n\n    print("\ud83d\udd17 ENLLAÇOS TROBATS A LA PÀGINA:\\n")\n    for link in soup.find_all("a", href=True): # Alg32: Busca tots els enllaços de la pàgina\n        print(link["href"])\n\n    print("\\n" + "="*80 + "\\n")\n\n    print("\ud83d\udcdd ENCAPÇALAMENTS TROBATS:\\n")\n    for header in soup.find_all(["h1", "h2", "h3", "h4", "h5", "h6"]): # Alg34: Extreu tots els encapçalaments (h1-h6)\n        print(f"{header.name.upper()}: {header.text}") # Alg35: Mostra el tipus d'encapçalament i el seu text\nelse:  # Alg36: Gestió d'error si la petició no ha estat exitosa\n    print(f"\u26a0\ufe0f Error carregant la pàgina (Codi {response.status_code})") # Alg37: Mostra el codi d'error de la petició\n\n# ==============================\n# BUCLE DEL XAT\n# ==============================\n\nfrom flask import Flask, request, jsonify\nfrom flask_cors import CORS  # Importa Flask-CORS\nfrom pyngrok import ngrok\n\napp = Flask(__name__) # Alg38: Crea una instància de l'aplicació Flask\nCORS(app)  # Alg39: Activa CORS per permetre peticions des de diferents orígens\n\nngrok.set_auth_token("2uTpEJU6jYqOIOXrL4NDYFpSu8R_4stuSzXJ3Bv64N5rr5auN") # Alg40: Configura el token d'autenticació per a Ngrok\n\n\n# Iniciar Ngrok i exposar el servidor\npublic_url = ngrok.connect(5000) # Alg41: Exposa l'aplicació Flask a través d'Ngrok a la porta 5000\nprint("\ud83c\udf0d URL pública del backend:", public_url) # Alg42: Mostra la URL pública per accedir al servidor\n\n@app.route("\/chat", methods=["POST"]) # Alg43: Defineix la ruta '\/chat' per a les peticions POST\ndef chat_route():# Alg44: Funció que gestiona la petició del xat\n    data = request.get_json() # Alg45: Obté les dades JSON enviades pel frontend\n    message = data.get("message", "") # Alg46: Extreu el missatge del JSON\n\n    try:\n        response = chat.send_message(message) # Alg47: Envia el missatge al model GenAI\n        return jsonify({"response": response.text.strip()}) # Alg48: Retorna la resposta generada pel model\n    except Exception as e: # Alg49: Captura errors durant la comunicació amb GenAI\n        print(f"\u26a0\ufe0f Error en la comunicació amb Gemini: {e}")  # Alg50: Mostra el missatge d'error\n        return jsonify({"response": "S'ha produït un error. Torna-ho a intentar més tard."}) # Alg51: Resposta d'error al frontend\n\nif __name__ == "__main__": # Alg52: Condició per a executar el servidor si el script es llanci directament\n    print("\ud83d\udd25 Servidor en funcionament! Usa aquesta URL en el teu frontend:") # Alg53: Mostra un missatge indicant que el servidor està actiu\n    app.run(port=5000) # Alg54: Inicia el servidor Flask a la porta 5000<\/code><\/pre>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"
    codi net i ben documentat (comentaris al codi) Tornar al repte 1.6 He\u00a0 organitzat el codi en Google Colabs de una manera organitzada i neta (#). 1. Comentaris detallats -Comentaris a cada pas del codi (Alg1, Alg2, Alg3…) que expliquen la funcionalitat de cada l\u00ednia. -Explicaci\u00f3 de condicions i possibles errors, per exemple: –Divisi\u00f3 en seccions clares: El codi est\u00e0 estructurat amb l\u00ednies de separaci\u00f3 # ============================== que ajuden a identificar r\u00e0pidament cada bloc funcional (Configuraci\u00f3 de l’API, Web Scraping, Servidor Flask, etc.). –Ordre l\u00f2gic: Les importacions de llibreries es fan primer, seguides de la configuraci\u00f3 de l\u2019API, la configuraci\u00f3 del xat, l’extracci\u00f3 d’informaci\u00f3 de la web i finalment l\u2019inici del servidor. Aquest codi est\u00e0 ben estructurat perqu\u00e8 segueix un ordre l\u00f2gic i organitzat, facilitant la seva lectura i manteniment: Aix\u00f2 garanteix que tots els m\u00f2duls estiguin disponibles abans d’importar-los. 2. Organitzaci\u00f3 Aquest codi est\u00e0 ordenat en un flux l\u00f2gic de dalt a baix: Instal\u00b7laci\u00f3 de llibreries (per evitar errors d’importaci\u00f3). Importaci\u00f3 de llibreries (seguint una l\u00f2gica de depend\u00e8ncies). Configuraci\u00f3 de l’API (comprova si la clau d’API est\u00e0 disponible). Instruccions del sistema (estableix normes i estil de resposta de l\u2019IA). Configuraci\u00f3 del model d’IA (defineix el model i par\u00e0metres). Extracci\u00f3 de dades web (web scraping). Configuraci\u00f3 del servidor Flask (per permetre comunicaci\u00f3 amb el frontend). Definici\u00f3 de la ruta de xat (per gestionar les converses). Execuci\u00f3 del servidor (per posar en marxa el sistema). 2.1 Instal\u00b7laci\u00f3 de llibreries Primer, el codi assegura que totes les llibreries necess\u00e0ries estiguin instal\u00b7lades abans de continuar. Aix\u00f2 evita errors si alguna no est\u00e0 disponible en l’entorn on s’executa. Despr\u00e9s de la instal\u00b7laci\u00f3, el codi importa totes les llibreries necess\u00e0ries per funcionar: L’ordre d’importaci\u00f3 segueix una l\u00f2gica: primer les eines per web scraping (BeautifulSoup, requests), despr\u00e9s la IA (genai), i finalment el servidor (Flask, ngrok). # La primera vegada, desmarca la línia de sota per a instal·lar la biblioteca # Només desmarcar si no tens les llibreries instal·lades prèviament !pip install google-genai # Alg1: Instal·la la llibreria google-genai per interactuar amb el model GenAI !pip install beautifulsoup4 requests # Alg2: Instal·la BeautifulSoup per web scraping i requests per fer peticions HTTP !pip install flask flask-ngrok # Alg3: Instal·la Flask per crear el servidor web i Flask-ngrok per exposar el servidor !pip install flask pyngrok # Alg4: Instal·la Flask per crear el servidor i pyngrok per crear túnels amb Ngrok !pip install flask-cors # Alg5: Instal·la Flask-CORS per gestionar CORS (peticions des de diferents orígens) import bs4 # Alg6: Importa BeautifulSoup per analitzar el contingut HTML de les pàgines web import requests # Alg7: Importa requests per fer peticions HTTP from flask_cors import CORS # Alg8: Importa CORS per activar la compartició de recursos entre diferents orígens from google import genai # Alg9: Importa la llibreria de GenAI per generar respostes amb el model de Google from google.colab import userdata # Alg10: Importa userdata per obtenir dades d'usuari a Google Colab from bs4 import BeautifulSoup # Alg11: Torna a importar BeautifulSoup per a l'anàlisi HTML from flask import Flask, request, jsonify # Alg12: Importa Flask per gestionar el servidor web i les peticions HTT from pyngrok import ngrok # Alg13: Importa ngrok per crear un túnel per a l'aplicació web local # ============================== # CONFIGURACIÓ DE L'API # ============================== GOOGLE_API_KEY = userdata.get("GOOGLE_API_KEY") # Alg14: Obté la clau API de Google des de userdata a Google Colab if not GOOGLE_API_KEY: # Alg15: Comprova si la clau API s'ha configurat correctament print("\u26a0\ufe0f No s'ha trobat la clau API. Configura-la a Colab abans d'executar el programa.") # Alg16: Missatge d'error si la clau no es troba exit() # Alg17: Termina l'execució del programa si la clau API no es troba client = genai.Client(api_key=GOOGLE_API_KEY) # Alg18: Crea una instància del client de GenAI amb la clau API # ============================== # INSTRUCCIONS DEL SISTEMA # ============================== system_instruction =""" Ets un alumne del cicle de sistemes microinformàtics i xarxes a l’Institut Castellbisbal. Et dius Ana Borrego Toledo i estás cursant un grau mitjà de Sistemes microinformàtics i xarxes. Respon amb un to divertit i enginyós. estil desenfadat, però sense faltar al respecte. \ud83d\udccc **Normes de comportament**: – **Respon només a preguntes relacionades amb el cicle, la teva web i el teu perfil acadèmic.** – **Ignora** qualsevol comentari fora de lloc, incloent temes personals, polítics o no relacionats amb l'àmbit acadèmic. – **No responguis** a comentaris ofensius, grollers o innecessaris. – Si algú fa una pregunta fora de context, com per exemple: "Ai ai… crec que el meu cable de xarxa s'ha desconnectat! No puc respondre això!" "Això no està dins del meu contracte de chatbot! Pregunta’m sobre informàtica!" En el cicle de sistemes microinformàtics i xarxes que curses es treballa a partir de REPTES. En cada REPTE, primer realitzes una sèrie de tasques que et permeten tocar diferents temes o conceptes del mòdul. Quan acabes el repte, passes a la fase de manaments, on demostres que has adquirit nous coneixements a través de les tasques realitzades. Aquesta fase és l’encarregada de valorar si has entès correctament el contingut i, en base a això, es decideix si aproves o no el mòdul i els coneixements. Els REPTES es fan en grup o individualment. Ignora els comentaris fora de lloc, axí com comentaris sexuals, personals…""" chat = client.chats.create( # Alg20: Crea una sessió de xat amb historial automàtic i instruccions personalitzades model="gemini-2.0-flash", # Alg21: Configura el model de llenguatge (verifica que sigui compatible amb la versió de GenAI) config=genai.types.GenerateContentConfig( # Alg22: Configura les opcions del model de llenguatge system_instruction=system_instruction, # Alg23: Inclou les instruccions per personalitzar el comportament temperature=0.7, # Alg24: Configura el nivell de creativitat del model (0 a 1, on 0 és més determinista) max_output_tokens=200 # Alg25: Configura la longitud màxima de la resposta generada ) ) # ============================== # EXTRAURE INFORMACIÓ DE LA PÀGINA WEB (web scrapping) # ============================== url = "https:\/\/aborrego.inscastellbisbal.net\/ipop\/" # Alg26: URL de la pàgina web de la qual es vol extreure informació response = requests.get(url) # Alg27: Realitza una petició GET per obtenir el contingut HTML … Read more<\/a><\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[95,84],"tags":[],"class_list":["post-6234","post","type-post","status-publish","format-standard","hentry","category-repte-1-6","category-disseny-i-aplicacio-de-la-ia"],"yoast_head":"\nCodi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo<\/title>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Codi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo\" \/>\n<meta property=\"og:description\" content=\"codi net i ben documentat (comentaris al codi) Tornar al repte 1.6 He\u00a0 organitzat el codi en Google Colabs de una manera organitzada i neta (#). 1. Comentaris detallats -Comentaris a cada pas del codi (Alg1, Alg2, Alg3…) que expliquen la funcionalitat de cada l\u00ednia. -Explicaci\u00f3 de condicions i possibles errors, per exemple: –Divisi\u00f3 en seccions clares: El codi est\u00e0 estructurat amb l\u00ednies de separaci\u00f3 # ============================== que ajuden a identificar r\u00e0pidament cada bloc funcional (Configuraci\u00f3 de l’API, Web Scraping, Servidor Flask, etc.). –Ordre l\u00f2gic: Les importacions de llibreries es fan primer, seguides de la configuraci\u00f3 de l\u2019API, la configuraci\u00f3 del xat, l’extracci\u00f3 d’informaci\u00f3 de la web i finalment l\u2019inici del servidor. Aquest codi est\u00e0 ben estructurat perqu\u00e8 segueix un ordre l\u00f2gic i organitzat, facilitant la seva lectura i manteniment: Aix\u00f2 garanteix que tots els m\u00f2duls estiguin disponibles abans d’importar-los. 2. Organitzaci\u00f3 Aquest codi est\u00e0 ordenat en un flux l\u00f2gic de dalt a baix: Instal\u00b7laci\u00f3 de llibreries (per evitar errors d’importaci\u00f3). Importaci\u00f3 de llibreries (seguint una l\u00f2gica de depend\u00e8ncies). Configuraci\u00f3 de l’API (comprova si la clau d’API est\u00e0 disponible). Instruccions del sistema (estableix normes i estil de resposta de l\u2019IA). Configuraci\u00f3 del model d’IA (defineix el model i par\u00e0metres). Extracci\u00f3 de dades web (web scraping). Configuraci\u00f3 del servidor Flask (per permetre comunicaci\u00f3 amb el frontend). Definici\u00f3 de la ruta de xat (per gestionar les converses). Execuci\u00f3 del servidor (per posar en marxa el sistema). 2.1 Instal\u00b7laci\u00f3 de llibreries Primer, el codi assegura que totes les llibreries necess\u00e0ries estiguin instal\u00b7lades abans de continuar. Aix\u00f2 evita errors si alguna no est\u00e0 disponible en l’entorn on s’executa. Despr\u00e9s de la instal\u00b7laci\u00f3, el codi importa totes les llibreries necess\u00e0ries per funcionar: L’ordre d’importaci\u00f3 segueix una l\u00f2gica: primer les eines per web scraping (BeautifulSoup, requests), despr\u00e9s la IA (genai), i finalment el servidor (Flask, ngrok). # La primera vegada, desmarca la línia de sota per a instal·lar la biblioteca # Només desmarcar si no tens les llibreries instal·lades prèviament !pip install google-genai # Alg1: Instal·la la llibreria google-genai per interactuar amb el model GenAI !pip install beautifulsoup4 requests # Alg2: Instal·la BeautifulSoup per web scraping i requests per fer peticions HTTP !pip install flask flask-ngrok # Alg3: Instal·la Flask per crear el servidor web i Flask-ngrok per exposar el servidor !pip install flask pyngrok # Alg4: Instal·la Flask per crear el servidor i pyngrok per crear túnels amb Ngrok !pip install flask-cors # Alg5: Instal·la Flask-CORS per gestionar CORS (peticions des de diferents orígens) import bs4 # Alg6: Importa BeautifulSoup per analitzar el contingut HTML de les pàgines web import requests # Alg7: Importa requests per fer peticions HTTP from flask_cors import CORS # Alg8: Importa CORS per activar la compartició de recursos entre diferents orígens from google import genai # Alg9: Importa la llibreria de GenAI per generar respostes amb el model de Google from google.colab import userdata # Alg10: Importa userdata per obtenir dades d'usuari a Google Colab from bs4 import BeautifulSoup # Alg11: Torna a importar BeautifulSoup per a l'anàlisi HTML from flask import Flask, request, jsonify # Alg12: Importa Flask per gestionar el servidor web i les peticions HTT from pyngrok import ngrok # Alg13: Importa ngrok per crear un túnel per a l'aplicació web local # ============================== # CONFIGURACIÓ DE L'API # ============================== GOOGLE_API_KEY = userdata.get("GOOGLE_API_KEY") # Alg14: Obté la clau API de Google des de userdata a Google Colab if not GOOGLE_API_KEY: # Alg15: Comprova si la clau API s'ha configurat correctament print("\u26a0\ufe0f No s'ha trobat la clau API. Configura-la a Colab abans d'executar el programa.") # Alg16: Missatge d'error si la clau no es troba exit() # Alg17: Termina l'execució del programa si la clau API no es troba client = genai.Client(api_key=GOOGLE_API_KEY) # Alg18: Crea una instància del client de GenAI amb la clau API # ============================== # INSTRUCCIONS DEL SISTEMA # ============================== system_instruction =""" Ets un alumne del cicle de sistemes microinformàtics i xarxes a l’Institut Castellbisbal. Et dius Ana Borrego Toledo i estás cursant un grau mitjà de Sistemes microinformàtics i xarxes. Respon amb un to divertit i enginyós. estil desenfadat, però sense faltar al respecte. \ud83d\udccc **Normes de comportament**: - **Respon només a preguntes relacionades amb el cicle, la teva web i el teu perfil acadèmic.** - **Ignora** qualsevol comentari fora de lloc, incloent temes personals, polítics o no relacionats amb l'àmbit acadèmic. - **No responguis** a comentaris ofensius, grollers o innecessaris. - Si algú fa una pregunta fora de context, com per exemple: "Ai ai... crec que el meu cable de xarxa s'ha desconnectat! No puc respondre això!" "Això no està dins del meu contracte de chatbot! Pregunta’m sobre informàtica!" En el cicle de sistemes microinformàtics i xarxes que curses es treballa a partir de REPTES. En cada REPTE, primer realitzes una sèrie de tasques que et permeten tocar diferents temes o conceptes del mòdul. Quan acabes el repte, passes a la fase de manaments, on demostres que has adquirit nous coneixements a través de les tasques realitzades. Aquesta fase és l’encarregada de valorar si has entès correctament el contingut i, en base a això, es decideix si aproves o no el mòdul i els coneixements. Els REPTES es fan en grup o individualment. Ignora els comentaris fora de lloc, axí com comentaris sexuals, personals...""" chat = client.chats.create( # Alg20: Crea una sessió de xat amb historial automàtic i instruccions personalitzades model="gemini-2.0-flash", # Alg21: Configura el model de llenguatge (verifica que sigui compatible amb la versió de GenAI) config=genai.types.GenerateContentConfig( # Alg22: Configura les opcions del model de llenguatge system_instruction=system_instruction, # Alg23: Inclou les instruccions per personalitzar el comportament temperature=0.7, # Alg24: Configura el nivell de creativitat del model (0 a 1, on 0 és més determinista) max_output_tokens=200 # Alg25: Configura la longitud màxima de la resposta generada ) ) # ============================== # EXTRAURE INFORMACIÓ DE LA PÀGINA WEB (web scrapping) # ============================== url = "https:\/\/aborrego.inscastellbisbal.net\/ipop\/" # Alg26: URL de la pàgina web de la qual es vol extreure informació response = requests.get(url) # Alg27: Realitza una petició GET per obtenir el contingut HTML ... Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/aborrego.inscastellbisbal.net\/en\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/\" \/>\n<meta property=\"og:site_name\" content=\"Ana Borrego Toledo\" \/>\n<meta property=\"article:published_time\" content=\"2025-03-19T08:34:34+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-25T12:19:50+00:00\" \/>\n<meta name=\"author\" content=\"aborrego\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"aborrego\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/\"},\"author\":{\"name\":\"aborrego\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#\\\/schema\\\/person\\\/596b5d3dc4735c43cfaafed47741b9d1\"},\"headline\":\"Codi net i ben documentat (Comentaris al codi)\",\"datePublished\":\"2025-03-19T08:34:34+00:00\",\"dateModified\":\"2025-03-25T12:19:50+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/\"},\"wordCount\":330,\"publisher\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#organization\"},\"articleSection\":[\"Repte 1.6\",\"\ud83e\udd16- Disseny i aplicaci\u00f3 de la IA\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/\",\"url\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/\",\"name\":\"Codi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#website\"},\"datePublished\":\"2025-03-19T08:34:34+00:00\",\"dateModified\":\"2025-03-25T12:19:50+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/2025\\\/03\\\/19\\\/codi-net-i-ben-documentat-comentaris-al-codi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Codi net i ben documentat (Comentaris al codi)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#website\",\"url\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/\",\"name\":\"Ana Borrego Toledo\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#organization\",\"name\":\"Ana Borrego Toledo\",\"url\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/wp-content\\\/uploads\\\/2025\\\/03\\\/cropped-Selection_255.png\",\"contentUrl\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/wp-content\\\/uploads\\\/2025\\\/03\\\/cropped-Selection_255.png\",\"width\":549,\"height\":328,\"caption\":\"Ana Borrego Toledo\"},\"image\":{\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/#\\\/schema\\\/person\\\/596b5d3dc4735c43cfaafed47741b9d1\",\"name\":\"aborrego\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g\",\"caption\":\"aborrego\"},\"sameAs\":[\"https:\\\/\\\/aborrego.inscastellbisbal.net\",\"https:\\\/\\\/www.instagram.com\\\/anaaaa.aaaaaaaaaaaaaaaaaaaaa?igsh=MWVqcmx5MXl5eGdxaw==\"],\"url\":\"https:\\\/\\\/aborrego.inscastellbisbal.net\\\/en\\\/author\\\/aborrego\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Codi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"en_US","og_type":"article","og_title":"Codi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo","og_description":"codi net i ben documentat (comentaris al codi) Tornar al repte 1.6 He\u00a0 organitzat el codi en Google Colabs de una manera organitzada i neta (#). 1. Comentaris detallats -Comentaris a cada pas del codi (Alg1, Alg2, Alg3…) que expliquen la funcionalitat de cada l\u00ednia. -Explicaci\u00f3 de condicions i possibles errors, per exemple: –Divisi\u00f3 en seccions clares: El codi est\u00e0 estructurat amb l\u00ednies de separaci\u00f3 # ============================== que ajuden a identificar r\u00e0pidament cada bloc funcional (Configuraci\u00f3 de l’API, Web Scraping, Servidor Flask, etc.). –Ordre l\u00f2gic: Les importacions de llibreries es fan primer, seguides de la configuraci\u00f3 de l\u2019API, la configuraci\u00f3 del xat, l’extracci\u00f3 d’informaci\u00f3 de la web i finalment l\u2019inici del servidor. Aquest codi est\u00e0 ben estructurat perqu\u00e8 segueix un ordre l\u00f2gic i organitzat, facilitant la seva lectura i manteniment: Aix\u00f2 garanteix que tots els m\u00f2duls estiguin disponibles abans d’importar-los. 2. Organitzaci\u00f3 Aquest codi est\u00e0 ordenat en un flux l\u00f2gic de dalt a baix: Instal\u00b7laci\u00f3 de llibreries (per evitar errors d’importaci\u00f3). Importaci\u00f3 de llibreries (seguint una l\u00f2gica de depend\u00e8ncies). Configuraci\u00f3 de l’API (comprova si la clau d’API est\u00e0 disponible). Instruccions del sistema (estableix normes i estil de resposta de l\u2019IA). Configuraci\u00f3 del model d’IA (defineix el model i par\u00e0metres). Extracci\u00f3 de dades web (web scraping). Configuraci\u00f3 del servidor Flask (per permetre comunicaci\u00f3 amb el frontend). Definici\u00f3 de la ruta de xat (per gestionar les converses). Execuci\u00f3 del servidor (per posar en marxa el sistema). 2.1 Instal\u00b7laci\u00f3 de llibreries Primer, el codi assegura que totes les llibreries necess\u00e0ries estiguin instal\u00b7lades abans de continuar. Aix\u00f2 evita errors si alguna no est\u00e0 disponible en l’entorn on s’executa. Despr\u00e9s de la instal\u00b7laci\u00f3, el codi importa totes les llibreries necess\u00e0ries per funcionar: L’ordre d’importaci\u00f3 segueix una l\u00f2gica: primer les eines per web scraping (BeautifulSoup, requests), despr\u00e9s la IA (genai), i finalment el servidor (Flask, ngrok). # La primera vegada, desmarca la línia de sota per a instal·lar la biblioteca # Només desmarcar si no tens les llibreries instal·lades prèviament !pip install google-genai # Alg1: Instal·la la llibreria google-genai per interactuar amb el model GenAI !pip install beautifulsoup4 requests # Alg2: Instal·la BeautifulSoup per web scraping i requests per fer peticions HTTP !pip install flask flask-ngrok # Alg3: Instal·la Flask per crear el servidor web i Flask-ngrok per exposar el servidor !pip install flask pyngrok # Alg4: Instal·la Flask per crear el servidor i pyngrok per crear túnels amb Ngrok !pip install flask-cors # Alg5: Instal·la Flask-CORS per gestionar CORS (peticions des de diferents orígens) import bs4 # Alg6: Importa BeautifulSoup per analitzar el contingut HTML de les pàgines web import requests # Alg7: Importa requests per fer peticions HTTP from flask_cors import CORS # Alg8: Importa CORS per activar la compartició de recursos entre diferents orígens from google import genai # Alg9: Importa la llibreria de GenAI per generar respostes amb el model de Google from google.colab import userdata # Alg10: Importa userdata per obtenir dades d'usuari a Google Colab from bs4 import BeautifulSoup # Alg11: Torna a importar BeautifulSoup per a l'anàlisi HTML from flask import Flask, request, jsonify # Alg12: Importa Flask per gestionar el servidor web i les peticions HTT from pyngrok import ngrok # Alg13: Importa ngrok per crear un túnel per a l'aplicació web local # ============================== # CONFIGURACIÓ DE L'API # ============================== GOOGLE_API_KEY = userdata.get("GOOGLE_API_KEY") # Alg14: Obté la clau API de Google des de userdata a Google Colab if not GOOGLE_API_KEY: # Alg15: Comprova si la clau API s'ha configurat correctament print("\u26a0\ufe0f No s'ha trobat la clau API. Configura-la a Colab abans d'executar el programa.") # Alg16: Missatge d'error si la clau no es troba exit() # Alg17: Termina l'execució del programa si la clau API no es troba client = genai.Client(api_key=GOOGLE_API_KEY) # Alg18: Crea una instància del client de GenAI amb la clau API # ============================== # INSTRUCCIONS DEL SISTEMA # ============================== system_instruction =""" Ets un alumne del cicle de sistemes microinformàtics i xarxes a l’Institut Castellbisbal. Et dius Ana Borrego Toledo i estás cursant un grau mitjà de Sistemes microinformàtics i xarxes. Respon amb un to divertit i enginyós. estil desenfadat, però sense faltar al respecte. \ud83d\udccc **Normes de comportament**: - **Respon només a preguntes relacionades amb el cicle, la teva web i el teu perfil acadèmic.** - **Ignora** qualsevol comentari fora de lloc, incloent temes personals, polítics o no relacionats amb l'àmbit acadèmic. - **No responguis** a comentaris ofensius, grollers o innecessaris. - Si algú fa una pregunta fora de context, com per exemple: "Ai ai... crec que el meu cable de xarxa s'ha desconnectat! No puc respondre això!" "Això no està dins del meu contracte de chatbot! Pregunta’m sobre informàtica!" En el cicle de sistemes microinformàtics i xarxes que curses es treballa a partir de REPTES. En cada REPTE, primer realitzes una sèrie de tasques que et permeten tocar diferents temes o conceptes del mòdul. Quan acabes el repte, passes a la fase de manaments, on demostres que has adquirit nous coneixements a través de les tasques realitzades. Aquesta fase és l’encarregada de valorar si has entès correctament el contingut i, en base a això, es decideix si aproves o no el mòdul i els coneixements. Els REPTES es fan en grup o individualment. Ignora els comentaris fora de lloc, axí com comentaris sexuals, personals...""" chat = client.chats.create( # Alg20: Crea una sessió de xat amb historial automàtic i instruccions personalitzades model="gemini-2.0-flash", # Alg21: Configura el model de llenguatge (verifica que sigui compatible amb la versió de GenAI) config=genai.types.GenerateContentConfig( # Alg22: Configura les opcions del model de llenguatge system_instruction=system_instruction, # Alg23: Inclou les instruccions per personalitzar el comportament temperature=0.7, # Alg24: Configura el nivell de creativitat del model (0 a 1, on 0 és més determinista) max_output_tokens=200 # Alg25: Configura la longitud màxima de la resposta generada ) ) # ============================== # EXTRAURE INFORMACIÓ DE LA PÀGINA WEB (web scrapping) # ============================== url = "https:\/\/aborrego.inscastellbisbal.net\/ipop\/" # Alg26: URL de la pàgina web de la qual es vol extreure informació response = requests.get(url) # Alg27: Realitza una petició GET per obtenir el contingut HTML ... Read more","og_url":"https:\/\/aborrego.inscastellbisbal.net\/en\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/","og_site_name":"Ana Borrego Toledo","article_published_time":"2025-03-19T08:34:34+00:00","article_modified_time":"2025-03-25T12:19:50+00:00","author":"aborrego","twitter_card":"summary_large_image","twitter_misc":{"Written by":"aborrego","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/#article","isPartOf":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/"},"author":{"name":"aborrego","@id":"https:\/\/aborrego.inscastellbisbal.net\/#\/schema\/person\/596b5d3dc4735c43cfaafed47741b9d1"},"headline":"Codi net i ben documentat (Comentaris al codi)","datePublished":"2025-03-19T08:34:34+00:00","dateModified":"2025-03-25T12:19:50+00:00","mainEntityOfPage":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/"},"wordCount":330,"publisher":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/#organization"},"articleSection":["Repte 1.6","\ud83e\udd16- Disseny i aplicaci\u00f3 de la IA"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/","url":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/","name":"Codi net i ben documentat (Comentaris al codi) - Ana Borrego Toledo","isPartOf":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/#website"},"datePublished":"2025-03-19T08:34:34+00:00","dateModified":"2025-03-25T12:19:50+00:00","breadcrumb":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/aborrego.inscastellbisbal.net\/2025\/03\/19\/codi-net-i-ben-documentat-comentaris-al-codi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/aborrego.inscastellbisbal.net\/"},{"@type":"ListItem","position":2,"name":"Codi net i ben documentat (Comentaris al codi)"}]},{"@type":"WebSite","@id":"https:\/\/aborrego.inscastellbisbal.net\/#website","url":"https:\/\/aborrego.inscastellbisbal.net\/","name":"Ana Borrego Toledo","description":"","publisher":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/aborrego.inscastellbisbal.net\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/aborrego.inscastellbisbal.net\/#organization","name":"Ana Borrego Toledo","url":"https:\/\/aborrego.inscastellbisbal.net\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/aborrego.inscastellbisbal.net\/#\/schema\/logo\/image\/","url":"https:\/\/aborrego.inscastellbisbal.net\/wp-content\/uploads\/2025\/03\/cropped-Selection_255.png","contentUrl":"https:\/\/aborrego.inscastellbisbal.net\/wp-content\/uploads\/2025\/03\/cropped-Selection_255.png","width":549,"height":328,"caption":"Ana Borrego Toledo"},"image":{"@id":"https:\/\/aborrego.inscastellbisbal.net\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/aborrego.inscastellbisbal.net\/#\/schema\/person\/596b5d3dc4735c43cfaafed47741b9d1","name":"aborrego","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e158785622f9364a28d322a7a8711e2ea34ebb67263b57ff915d7b49cb3cf0d1?s=96&d=mm&r=g","caption":"aborrego"},"sameAs":["https:\/\/aborrego.inscastellbisbal.net","https:\/\/www.instagram.com\/anaaaa.aaaaaaaaaaaaaaaaaaaaa?igsh=MWVqcmx5MXl5eGdxaw=="],"url":"https:\/\/aborrego.inscastellbisbal.net\/en\/author\/aborrego\/"}]}},"_links":{"self":[{"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/posts\/6234","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/comments?post=6234"}],"version-history":[{"count":10,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/posts\/6234\/revisions"}],"predecessor-version":[{"id":6470,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/posts\/6234\/revisions\/6470"}],"wp:attachment":[{"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/media?parent=6234"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/categories?post=6234"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aborrego.inscastellbisbal.net\/en\/wp-json\/wp\/v2\/tags?post=6234"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}