Kodi

Përdorni <code> për kodin inline dhe <pre class="prettyprint"> për blloqet e kodit. Theksimi i sintaksës funksionon mirë për shumë gjuhë, duke përfshirë shembujt XML dhe HTML. Mund të anashkaloni class="prettyprint" nëse theksimi i sintaksës nuk është i përshtatshëm për shembullin, si p.sh. për komandat e konsolës ose URL-të e pikës fundore të shërbimit të gjatë.

Mos i kaloni 100 karaktere kodi për rresht në një bllok <pre> . Në DevSite, saktësisht 100 karaktere kodi do të përshtaten në ekranet më të mëdhenj përpara se të fillojë lëvizja horizontale. Në ekranet më të vogla, blloqet e kodit do të lëvizin horizontalisht kur është e nevojshme. 80 karaktere përshtaten pothuajse në çdo laptop.

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

Në mënyrë tipike do të hiqje class="prettyprint" nga <pre> për komandat e konsolës. Për shembull:

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

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

Kliko për të kopjuar

Një buton "klikoni për të kopjuar" shfaqet automatikisht në të gjitha blloqet e kodit me klasën prettyprint .

Për të përdorur click-to-copy në një bllok kodi ose një element tjetër që nuk ka klasën prettyprint , shtoni klasën 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>

Çaktivizimi i klikimit për të kopjuar në një bllok kodi

Për të çaktivizuar click-to-copy në një bllok kodi prettyprint , shtoni klasën 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>

Për të çaktivizuar klik-për-kopjimin në një bllok kodi Markdown , përdorni sintaksën e mëposhtme kur hapni gardhin e kodit për të aplikuar stilin devsite-disable-click-to-copy :

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

Çaktivizimi i klikimit për të kopjuar në një pjesë të një blloku kodi

Për të parandaluar kopjimin e një pjese të një blloku kodi, shtoni një etiketë <span> me një klasë të no-select rreth pjesës që nuk dëshironi të kopjohet: 

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

Në shembullin e mëposhtëm, si kopjimi manual, ashtu edhe butoni kliko për të kopjuar injorojnë pjesën e shënuar:

C:\\> ping google.com

Ngjarjet analitike klikoni për të kopjuar

Për të zbardhur ngjarjet analitike klikoni për të kopjuar, vendosni atributin data-copy-event-label . 

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

Kliko-për-kopje dhe aksesueshmëri

Si parazgjedhje, të gjitha mostrat e kodit "klikoni për të kopjuar" kanë të njëjtën etiketë për çdo buton "kliko për të kopjuar": "Kopjo mostrën e kodit". Në faqet me mostra të shumta kodesh, kjo mund ta bëjë të vështirë navigimin me një lexues ekrani.

Për akses, jepni çdo mostër kodi klikoni për të kopjuar një atribut data-label që etiketon shkurtimisht dhe në mënyrë koncize përmbajtjen e secilit mostër kodi. Çdo etiketë e mostrës së kodit duhet të jetë unike në krahasim me të gjitha etiketat e tjera të mostrës së kodit në faqe; kjo etiketë lexohet nga lexuesit e ekranit përveç "Kopjo mostrën e kodit". {:.devsite-click-to-copy} <pre class="devsite-click-to-copy" data-label="Installation script"></pre>

Çaktivizimi i ndërrimit dritë/errësirë

Për të çaktivizuar butonin e ndërrimit dritë/errësi në një bllok kodesh, shtoni klasën devsite-disable-code-toggle : 

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

Për të çaktivizuar butonin e ndezjes dritë/errësi në një bllok kodi Markdown , përdorni sintaksën e mëposhtme kur hapni gardhin e kodit për të aplikuar klasën devsite-disable-code-toggle : 

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

Kodi i errët si parazgjedhje

Për të bërë një bllok kodi të përdorë stilimin e kodit të errët si parazgjedhje, shtoni klasën devsite-dark-code-default : 

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

Mbështjellja e linjës së forcës

Si parazgjedhje, një shirit lëvizës horizontal shtohet për rreshtat në një bllok <pre> që tejkalojnë 100 karaktere. 

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)

Për të anashkaluar këtë sjellje dhe për të mbështjellë rreshtat, shtoni class="wrap-code" në bllokun <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)

Kodi: 

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

Kodi i terminalit

Kur demonstroni kodin për terminalin, ne rekomandojmë që autorët të përdorin $ për të treguar një komandë të re terminali. Për të shtuar $ në fillim të përmbajtjes së një kontejneri <pre> pa e shtuar atë në kodin e kopjuar të përdoruesit, aplikoni class="devsite-terminal" në elementin <pre> .

adb devices

Kodi: 

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

Për të shtuar $ në fillim të një rreshti të vetëm të kodit terminal, aplikoni class="devsite-terminal" në elementin <code> që përmban atë rresht. Përdoreni këtë taktikë për rastet me $ në rreshta të shumëfishtë. 

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

Kodi: 

<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

Për të përdorur një prefiks të personalizuar, shtoni atributin data-terminal-prefix në elementin <pre> ose <code> ku është aplikuar klasa. 

Install-Package Google.Apis.Calendar.v3

Kodi: 

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

Të gjitha rastet e prefiksit të shtuar duke përdorur klasën "devsite-terminal" do të përjashtohen nga kodi i kopjuar i përdoruesit.

Duke theksuar

Përdorni <strong> për të tërhequr vëmendjen ndaj përmbajtjes brenda një blloku <pre> . Duke vepruar kështu do të lehtësojë përmbajtjen përreth për të theksuar seksionin e theksuar nga blloku <strong> . Për shembull: 

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

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

Kodi: 

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

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

Variabla të zëvendësueshëm

Përdorni <var> dhe shkronja të mëdha me nënvizime për tekst të zëvendësueshëm brenda <pre> . Për shembull: 

dev_appserver.py YOUR_APP_DIR.

Kodi: 

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

Në Markdown, mbyllni etiketat <var> në thonjëza dhe përdorni kllapat e shprehjes Jinja për t'i shpëtuar etiketave, si kjo: VAR_NAME .

Për shembull: 

Hello, my name is YOUR_NAME.

Kodi: 

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

Markdown

Ju gjithashtu mund të specifikoni blloqet e kodit duke përdorur Markdown ose me 4 hapsira duke e futur kodin ose duke e rrethuar atë me 3 mbrapa (```).

Për shembull: 

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

    print("hello world")

të dyja bëhen 

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

Nëse jeni duke përdorur blloqe kodesh të rrethuara (dhe jo blloqe kodi të futura), mund të specifikoni gjithashtu gjuhën për printim të bukur për ta kuptuar atë: 

print("hello world")

bëhet 

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

Lista e gjuhëve të njohura mund ta gjeni në dokumentacionin Prettify .

Të gjitha blloqet e kodit të bëra përmes Markdown do të kenë klasën e bukur print të aplikuar në të, përveç nëse e vendos gjuhën në mënyrë eksplicite në asnjë. Ju mund të shtoni klasa shtesë në bllokun e kodit duke përdorur atributet e personalizuara : 

The program completed successfully.

bëhet 

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