Koda

Uporabite <code> za vstavljeno kodo in <pre class="prettyprint"> za bloke kode. Označevanje sintakse deluje dobro za številne jezike, vključno s primeri XML in HTML. Izpustite lahko class="prettyprint" če označevanje sintakse ni primerno za primer, na primer za ukaze ukazne mize ali dolgoročne URL-je končne točke storitev.

Ne presezite 100 znakov kode na vrstico v bloku <pre> . V DevSite bo natanko 100 znakov kode ustrezalo večjim zaslonom, preden se bo začelo vodoravno pomikanje. Na manjših zaslonih se bodo kodni bloki po potrebi pomikali vodoravno. 80 znakov se prilega skoraj vsakemu prenosniku.

#include <stdio.h>

/* Counting example */
int main(int argc, char** argv) {
    int i;

    // This counts from 0 to 9.
    for (i = 0; i < 10; i++) {
        printf("Counting %d\n", i);
    }
}
<pre class="prettyprint">
#include <stdio.h>

/* Counting example */
int main(int argc, char** argv) {
    int i;

    // This counts from 0 to 9.
    for (i = 0; i < 10; i++) {
        printf("Counting %d\n", i);
    }
}
</pre>

Običajno bi izpustili class="prettyprint" iz <pre> za ukaze konzole. Na primer:

dev_appserver.py -a $HOST --debug demos/getstarted
<pre>dev_appserver.py -a $HOST --debug demos/getstarted</pre>

Kliknite za kopiranje

Gumb za kopiranje s klikom se samodejno prikaže na vseh blokih kode z razredom prettyprint .

Če želite uporabiti klik za kopiranje na bloku kode ali drugem elementu, ki nima razreda prettyprint , dodajte razred devsite-click-to-copy : some_terminal_command.py --users_should_copy <pre class="devsite-click-to-copy">some_terminal_command.py --users_should_copy</pre>

Onemogočanje klikni za kopiranje na bloku kode

Če želite onemogočiti klikni za kopiranje v kodnem bloku prettyprint , dodajte razred devsite-disable-click-to-copy :

www.example-url-that-does-not-make-sense-to-copy.com
<pre class="prettyprint devsite-disable-click-to-copy">www.example-url-that-does-not-make-sense-to-copy.com</pre>

Če želite onemogočiti klikni za kopiranje v bloku kode Markdown , uporabite naslednjo sintakso, ko odprete ograjo kode, da uporabite slog devsite-disable-click-to-copy :

{:.devsite-disable-click-to-copy}

Onemogočanje klikni za kopiranje na delu bloka kode

Če želite preprečiti kopiranje dela bloka kode, dodajte oznako <span> z razredom no-select okoli dela, ki ga ne želite kopirati:

<span class="no-select">C:\> </span>ping google.com

V spodnjem primeru tako ročno kopiranje kot tudi gumb za kopiranje s klikom prezreta opombe:

C:\\> ping google.com

Analitični dogodki s klikom za kopiranje

Če želite razjasniti dogodke analitike »klikni za kopiranje«, nastavite atribut data-copy-event-label .

data-copy-event-label
<pre class="devsite-terminal devsite-click-to-copy" data-copy-event-label="unique_identifier"></pre>

Klikni za kopiranje in dostopnost

Privzeto imajo vsi vzorci kode s klikom za kopiranje enako oznako za vsak gumb s klikom za kopiranje: »Kopiraj vzorec kode«. Na straneh z več vzorci kode lahko to oteži navigacijo z bralnikom zaslona.

Za dostopnost zagotovite vsakemu vzorcu kode s klikom za kopiranje atribut data-label , ki na kratko in jedrnato označi vsebino vsakega vzorca kode. Vsaka oznaka vzorca kode mora biti edinstvena glede na vse druge oznake vzorcev kode na strani; to oznako preberejo bralniki zaslona poleg oznake »Kopiraj vzorec kode«. {:.devsite-click-to-copy} <pre class="devsite-click-to-copy" data-label="Installation script"></pre>

Onemogočanje preklopa svetlo/temno

Če želite onemogočiti preklopni gumb svetlo/temno na bloku kode, dodajte razred devsite-disable-code-toggle :

<pre class="prettyprint devsite-disable-code-toggle"></pre>

Če želite onemogočiti preklopni gumb za svetlo/temno na kodnem bloku Markdown , uporabite naslednjo sintakso, ko odprete ograjo kode, da uporabite razred devsite-disable-code-toggle :

``` {.devsite-disable-code-toggle}

Temna koda privzeto

Če želite, da kodni blok privzeto uporablja temno oblikovanje kode, dodajte razred devsite-dark-code-default :

<pre class="prettyprint devsite-dark-code-default"></pre>

Prisilno ovijanje črte

Privzeto je za vrstice v bloku <pre> , ki presegajo 100 znakov, dodan vodoravni drsni trak.

run(dataset: google.cloud.aiplatform.datasets.time_series_dataset.TimeSeriesDataset, target_column: str, time_column: str, time_series_identifier_column: str, unavailable_at_forecast_columns: List[str], available_at_forecast_columns: List[str], forecast_horizon: int, data_granularity_unit: str, data_granularity_count: int, training_fraction_split: Optional[float] = None, validation_fraction_split: Optional[float] = None, test_fraction_split: Optional[float] = None, predefined_split_column_name: Optional[str] = None, weight_column: Optional[str] = None, time_series_attribute_columns: Optional[List[str]] = None, context_window: Optional[int] = None, export_evaluated_data_items: bool = False, export_evaluated_data_items_bigquery_destination_uri: Optional[str] = None, export_evaluated_data_items_override_destination: bool = False, quantiles: Optional[List[float]] = None, validation_options: Optional[str] = None, budget_milli_node_hours: int = 1000, model_display_name: Optional[str] = None, model_labels: Optional[Dict[str, str]] = None, sync: bool = True)

Če želite preglasiti to vedenje in namesto tega zaviti vrstice, dodajte class="wrap-code" v blok <pre> .

run(dataset: google.cloud.aiplatform.datasets.time_series_dataset.TimeSeriesDataset, target_column: str, time_column: str, time_series_identifier_column: str, unavailable_at_forecast_columns: List[str], available_at_forecast_columns: List[str], forecast_horizon: int, data_granularity_unit: str, data_granularity_count: int, training_fraction_split: Optional[float] = None, validation_fraction_split: Optional[float] = None, test_fraction_split: Optional[float] = None, predefined_split_column_name: Optional[str] = None, weight_column: Optional[str] = None, time_series_attribute_columns: Optional[List[str]] = None, context_window: Optional[int] = None, export_evaluated_data_items: bool = False, export_evaluated_data_items_bigquery_destination_uri: Optional[str] = None, export_evaluated_data_items_override_destination: bool = False, quantiles: Optional[List[float]] = None, validation_options: Optional[str] = None, budget_milli_node_hours: int = 1000, model_display_name: Optional[str] = None, model_labels: Optional[Dict[str, str]] = None, sync: bool = True)

Koda:

<pre class="wrap-code">
run(dataset: google.cloud.aiplatform.datasets.time_series_dataset.TimeSeriesDataset, target_column: str, time_column: str, time_series_identifier_column: str, unavailable_at_forecast_columns: List[str], available_at_forecast_columns: List[str], forecast_horizon: int, data_granularity_unit: str, data_granularity_count: int, training_fraction_split: Optional[float] = None, validation_fraction_split: Optional[float] = None, test_fraction_split: Optional[float] = None, predefined_split_column_name: Optional[str] = None, weight_column: Optional[str] = None, time_series_attribute_columns: Optional[List[str]] = None, context_window: Optional[int] = None, export_evaluated_data_items: bool = False, export_evaluated_data_items_bigquery_destination_uri: Optional[str] = None, export_evaluated_data_items_override_destination: bool = False, quantiles: Optional[List[float]] = None, validation_options: Optional[str] = None, budget_milli_node_hours: int = 1000, model_display_name: Optional[str] = None, model_labels: Optional[Dict[str, str]] = None, sync: bool = True)
</pre>

Koda terminala

Pri predstavitvi kode za terminal priporočamo, da avtorji uporabijo $ za označevanje novega terminalskega ukaza. Če želite dodati $ na začetek vsebine vsebnika <pre> , ne da bi ga dodali uporabniški kopirani kodi, uporabite class="devsite-terminal" za element <pre> .

adb devices

Koda:

<pre class="devsite-terminal devsite-click-to-copy">
adb devices
</pre>

Če želite dodati $ na začetek ene vrstice kode terminala, uporabite class="devsite-terminal" za element <code> , ki vsebuje to vrstico. Uporabite to taktiko za primere z $ v več vrsticah.

gradle init --type basic
mkdir -p src/main/java src/main/resources

Koda:

<pre class="prettyprint">
<code class="devsite-terminal">gradle init --type basic</code>
<code class="devsite-terminal">mkdir -p src/main/java src/main/resources</code>
</pre

Če želite uporabiti predpono po meri, dodajte atribut data-terminal-prefix elementu <pre> ali <code> , kjer je bil uporabljen razred.

Install-Package Google.Apis.Calendar.v3

Koda:

<pre class="devsite-terminal devsite-click-to-copy" data-terminal-prefix="PM&gt; ">
Install-Package Google.Apis.Calendar.v3
</pre>

Vsi primerki predpone, dodani z razredom "devsite-terminal", bodo izključeni iz uporabnikove kopirane kode.

Poudarjanje

Uporabite <strong> , da opozorite na vsebino znotraj bloka <pre> . S tem boste posvetlili okoliško vsebino in poudarili razdelek, označen z blokom <strong> . Na primer:

// ...
// ...
// ...
for (i = 0; i < 10; i++) {
    printf("Counting %d\n", i);

    if (i % 3 == 0) {
        someFunc(i);
    }
}
// ...
// ...
// ...

Koda:

<pre class="prettyprint">
// ...
// ...
// ...
for (i = 0; i < 10; i++) {
    printf("Counting %d\n", i);

    <strong>if (i % 3 == 0) {
        someFunc(i);
    }</strong>
}
// ...
// ...
// ...
</pre>

Zamenljive spremenljivke

Uporabite <var> in velike črke s podčrtaji za zamenljivo besedilo znotraj <pre> . Na primer:

dev_appserver.py YOUR_APP_DIR.

Koda:

<pre>dev_appserver.py <var>YOUR_APP_DIR</var></pre>

V Markdown stavite oznake <var> v narekovaje in uporabite izrazne oklepaje Jinja za ubežanje oznak, takole: VAR_NAME .

Na primer:

Hello, my name is YOUR_NAME.

Koda:

    ```
    Hello, my name is YOUR_NAME.
    ```

Markdown

Bloke kode lahko določite tudi z uporabo Markdown z zamikom kode s 4 presledki ali pa jo omejite s 3 povratnimi kljukicami (```).

Na primer:

    ```
    print("hello world")
    ```
    print("hello world")

oba postaneta

<pre class="prettyprint notranslate" translate="no"><code>
print("hello world")
</code></pre>

Če uporabljate ograjene kodne bloke (in ne zamaknjene kodne bloke), lahko določite tudi jezik za prettyprint, da ga razumete:

print("hello world")

postane

<pre class="prettyprint notranslate lang-py" translate="no"><code>
print("hello world")
</code></pre>

Seznam priznanih jezikov najdete v dokumentaciji Prettify .

Za vse bloke kode, izdelane prek Markdown, bo uporabljen razred prettyprint, razen če izrecno nastavite jezik na none. Bloku kode lahko dodate dodatne razrede z uporabo atributov po meri :

The program completed successfully.

postane

<pre class="devsite-disable-click-to-copy"><code>The program completed successfully.
</code></pre>