Kodas

Eilutiniam kodui naudokite <code> , o kodo blokams <pre class="prettyprint"> . Sintaksės paryškinimas gerai veikia daugelyje kalbų, įskaitant XML ir HTML pavyzdžius. Galite praleisti class="prettyprint" jei sintaksės paryškinimas netinka pavyzdžiui, pvz., konsolės komandoms arba ilgiems paslaugos galutinio taško URL.

Neviršykite 100 kodo simbolių vienoje eilutėje <pre> bloke. „DevSite“ tiksliai 100 kodo simbolių tilps didesniuose ekranuose, kol prasidės horizontalus slinkimas. Mažesniuose ekranuose kodo blokai prireikus slinks horizontaliai. 80 simbolių telpa beveik bet kuriame nešiojamajame kompiuteryje.

#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>

Paprastai konsolės komandoms praleidžiate class="prettyprint" iš <pre> . Pavyzdžiui:

dev_appserver.py -a $HOST --debug demos/getstarted

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

Spustelėkite ir nukopijuokite

Spustelėti ir kopijuoti mygtukas automatiškai pasirodo visuose kodo blokuose su klase prettyprint .

Jei norite kopijuoti spustelėjus kodo bloke ar kitame elemente, kuriame nėra klasės prettyprint , pridėkite klasę 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>

Kodo bloko spustelėjimo ir kopijavimo išjungimas

Norėdami išjungti kopijavimo spustelėjimą prettyprint kodo bloke, pridėkite klasę 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>

Norėdami išjungti kopijavimą spustelėjus Markdown kodo bloke , atidarydami kodo tvorą naudokite šią sintaksę, kad pritaikytumėte stilių devsite-disable-click-to-copy :

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

Išjungiamas kodo bloko dalies spustelėjimas ir kopijavimas

Kad nebūtų kopijuojama kodo bloko dalis, aplink dalį, kurios nenorite kopijuoti, pridėkite žymą <span> su klase no-select : 

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

Toliau pateiktame pavyzdyje tiek rankinis kopijavimas, tiek mygtukas „Spustelėti ir kopijuoti“ nepaiso anotuotos dalies:

C:\\> ping google.com

„Spustelėkite, kad nukopijuotumėte“ analizės įvykius

Norėdami išaiškinti spustelėjus ir kopijuoti atliekamus analizės įvykius, nustatykite atributą data-copy-event-label . 

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

Kopijuoti spustelėjus ir prieinamumas

Pagal numatytuosius nustatymus visi spustelėjus kopijuoti kodo pavyzdžiai turi tą pačią etiketę kiekvienam spustelėjus ir kopijuoti mygtukui: „Kopijuoti kodo pavyzdį“. Puslapiuose su keliais kodo pavyzdžiais dėl to gali būti sunku naršyti naudojant ekrano skaitytuvą.

Kad būtų lengviau pasiekti, kiekvienam spustelėjimu nukopijuojamam kodo pavyzdžiu pateikite data-label atributą, kuris trumpai ir glaustai žymi kiekvieno kodo pavyzdžio turinį. Kiekviena kodo pavyzdžio etiketė turi būti unikali, palyginti su visomis kitomis kodo pavyzdinėmis etiketėmis puslapyje; šią etiketę skaito ekrano skaitytuvai, be „Kopijuoti kodo pavyzdį“. {:.devsite-click-to-copy} <pre class="devsite-click-to-copy" data-label="Installation script"></pre>

Išjungiamas šviesos / tamsos perjungimas

Norėdami išjungti šviesos / tamsos perjungimo mygtuką kodo bloke, pridėkite klasę devsite-disable-code-toggle : 

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

Norėdami išjungti šviesos / tamsos perjungimo mygtuką Markdown kodo bloke , atidarydami kodo tvorą naudokite šią sintaksę, kad pritaikytumėte klasę devsite-disable-code-toggle : 

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

Tamsus kodas pagal numatytuosius nustatymus

Norėdami, kad kodo blokas naudotų tamsaus kodo stilių pagal numatytuosius nustatymus, pridėkite klasę devsite-dark-code-default : 

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

Jėgos linijos vyniojimas

Pagal numatytuosius nustatymus horizontali slinkties juosta pridedama prie <pre> bloko eilučių, kurios ilgesnės nei 100 simbolių. 

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)

Norėdami nepaisyti šios elgsenos ir vietoj to suvynioti eilutes, į bloką <pre> pridėkite 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)

Kodas: 

<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>

Terminalo kodas

Demonstruojant terminalo kodą, autoriams rekomenduojame naudoti $ , kad nurodytų naują terminalo komandą. Norėdami pridėti $ prie <pre> sudėtinio rodinio turinio pradžios nepridėdami jo prie vartotojo nukopijuoto kodo, elementui <pre> pritaikykite class="devsite-terminal" .

adb devices

Kodas: 

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

Norėdami pridėti $ prie vienos terminalo kodo eilutės pradžios, taikykite class="devsite-terminal" elementui <code> , kuriame yra ta eilutė. Naudokite šią taktiką tais atvejais, kai $ keliose eilutėse. 

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

Kodas: 

<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

Norėdami naudoti pasirinktinį priešdėlį, pridėkite atributą data-terminal-prefix prie elemento <pre> arba <code> , kuriame buvo pritaikyta klasė. 

Install-Package Google.Apis.Calendar.v3

Kodas: 

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

Visi priešdėlio, pridėto naudojant „devsite-terminal“ klasę, atvejai nebus įtraukti į naudotojo nukopijuotą kodą.

Paryškinimas

Naudokite <strong> , kad atkreiptumėte dėmesį į turinį <pre> bloke. Tai padarius pašviesinsite aplinkinį turinį, kad paryškintumėte skiltį, paryškintą <strong> bloku. Pavyzdžiui: 

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

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

Kodas: 

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

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

Keičiami kintamieji

Naudokite <var> ir didžiąsias raides su apatiniais brūkšniais, jei norite pakeisti tekstą <pre> . Pavyzdžiui: 

dev_appserver.py YOUR_APP_DIR.

Kodas: 

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

Markdown žymas <var> įdėkite į kabutes ir naudokite Jinja posakių skliaustus, kad pašalintumėte žymas, pavyzdžiui: VAR_NAME .

Pavyzdžiui: 

Hello, my name is YOUR_NAME.

Kodas: 

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

Pažymėjimas

Taip pat galite nurodyti kodo blokus naudodami „Markdown“ su 4 tarpų kodo įtrauka arba aptvėrę jį 3 varnelėmis (```).

Pavyzdžiui: 

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

    print("hello world")

abu tampa 

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

Jei naudojate aptvertus kodo blokus (o ne įtrauktus kodo blokus), taip pat galite nurodyti „Prettyprint“ kalbą, kad ją suprastumėte: 

print("hello world")

tampa 

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

Pripažintų kalbų sąrašą galite rasti Prettify dokumentacijoje .

Visiems kodo blokams, sudarytiems naudojant Markdown, bus pritaikyta „Prettyprint“ klasė, nebent kalba aiškiai nenustatyta. Galite pridėti papildomų klasių prie kodo bloko naudodami pasirinktinius atributus : 

The program completed successfully.

tampa 

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