کوڈ

ان لائن کوڈ کے لیے <code> اور کوڈ بلاکس کے لیے <pre class="prettyprint"> استعمال کریں۔ نحو کو نمایاں کرنا بہت سی زبانوں کے لیے بہتر کام کرتا ہے، بشمول XML اور HTML مثالیں۔ آپ class="prettyprint" کو چھوڑ سکتے ہیں اگر مثال کے لیے نحو کو نمایاں کرنا مناسب نہیں ہے، جیسے کہ کنسول کمانڈز یا طویل سروس اینڈ پوائنٹ یو آر ایل کے لیے۔

<pre> بلاک میں فی لائن کوڈ کے 100 حروف سے زیادہ نہ ہوں۔ DevSite میں، افقی اسکرولنگ شروع ہونے سے پہلے کوڈ کے بالکل 100 حروف بڑی اسکرینوں پر فٹ ہوجائیں گے۔ چھوٹی اسکرینوں پر، کوڈ بلاکس افقی طور پر اسکرول کریں گے جب ضروری ہو۔ کسی بھی لیپ ٹاپ پر 80 حروف فٹ ہوتے ہیں۔

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

کنسول کمانڈز کے لیے آپ عام طور پر <pre> سے class="prettyprint" چھوڑ دیں گے۔ مثال کے طور پر:

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

کاپی کرنے کے لیے کلک کریں۔

ایک کلک ٹو کاپی بٹن کلاس prettyprint کے ساتھ تمام کوڈ بلاکس پر خود بخود ظاہر ہوتا ہے۔

کسی کوڈ بلاک یا دوسرے عنصر پر کلک ٹو کاپی استعمال کرنے کے لیے جس میں کلاس prettyprint نہیں ہے، کلاس شامل کریں 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>

کوڈ بلاک پر کلک ٹو کاپی کو غیر فعال کرنا

ایک prettyprint کوڈ بلاک پر کلک ٹو کاپی کو غیر فعال کرنے کے لیے، کلاس شامل کریں 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>

مارک ڈاون کوڈ بلاک پر کلک ٹو کاپی کو غیر فعال کرنے کے لیے، جب آپ کوڈ کی باڑ کھولتے ہیں تو devsite-disable-click-to-copy سٹائل کو لاگو کرنے کے لیے درج ذیل نحو کا استعمال کریں:

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

کوڈ بلاک کے حصے پر کلک ٹو کاپی کو غیر فعال کرنا

کوڈ بلاک کے حصے کو کاپی کرنے سے روکنے کے لیے، اس حصے کے ارد گرد no-select کی کلاس کے ساتھ ایک <span> ٹیگ شامل کریں جسے آپ کاپی نہیں کرنا چاہتے:

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

نیچے دی گئی مثال میں، دستی کاپی کے ساتھ ساتھ کلک ٹو کاپی بٹن دونوں تشریح شدہ حصے کو نظر انداز کرتے ہیں:

C:\\> ping google.com

تجزیات کے واقعات کو کاپی کرنے کے لیے کلک کریں۔

کلک ٹو کاپی اینالیٹکس ایونٹس کو غیر واضح کرنے کے لیے، data-copy-event-label وصف سیٹ کریں۔

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

کاپی کرنے کے لیے کلک کریں اور رسائی

پہلے سے طے شدہ طور پر، تمام کلک ٹو کاپی کوڈ کے نمونوں میں ہر کلک ٹو کاپی بٹن کے لیے ایک ہی لیبل ہوتا ہے: "کوڈ کا نمونہ کاپی کریں۔" متعدد کوڈ نمونوں والے صفحات پر، یہ اسکرین ریڈر کے ساتھ نیویگیٹ کرنا مشکل بنا سکتا ہے۔

رسائی کے لیے، ہر کلک ٹو کاپی کوڈ کا نمونہ data-label خصوصیت کے ساتھ فراہم کریں جو ہر کوڈ کے نمونے کے مواد کو مختصر اور اختصار کے ساتھ لیبل کرتا ہے۔ ہر کوڈ کے نمونے کا لیبل صفحہ پر موجود دیگر تمام کوڈ نمونہ لیبلز کے مقابلے منفرد ہونا چاہیے۔ اس لیبل کو "کوڈ کا نمونہ کاپی کریں" کے علاوہ اسکرین ریڈرز پڑھتے ہیں۔ {:.devsite-click-to-copy} <pre class="devsite-click-to-copy" data-label="Installation script"></pre>

روشنی/تاریک ٹوگل کو غیر فعال کرنا

کوڈ بلاک پر لائٹ/ڈارک ٹوگل بٹن کو غیر فعال کرنے کے لیے، کلاس شامل کریں devsite-disable-code-toggle :

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

مارک ڈاؤن کوڈ بلاک پر لائٹ/ڈارک ٹوگل بٹن کو غیر فعال کرنے کے لیے، devsite-disable-code-toggle کلاس کو لاگو کرنے کے لیے کوڈ کی باڑ کھولتے وقت درج ذیل نحو کا استعمال کریں:

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

ڈارک کوڈ بطور ڈیفالٹ

کوڈ بلاک بنانے کے لیے بطور ڈیفالٹ ڈارک کوڈ اسٹائل استعمال کریں، کلاس شامل کریں devsite-dark-code-default :

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

زبردستی لائن ریپنگ

پہلے سے طے شدہ طور پر، ایک <pre> بلاک میں لائنوں کے لیے ایک افقی اسکرول بار شامل کیا جاتا ہے جو 100 حروف سے زیادہ ہیں۔

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> بلاک میں 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 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>

ٹرمینل کوڈ

ٹرمینل کے لیے کوڈ کا مظاہرہ کرتے وقت، ہم تجویز کرتے ہیں کہ مصنفین نئے ٹرمینل کمانڈ کی نشاندہی کرنے کے لیے $ استعمال کریں۔ صارف کے کاپی شدہ کوڈ میں شامل کیے بغیر کسی <pre> کنٹینر کے مواد کے آغاز میں $ شامل کرنے کے لیے، <pre> عنصر پر class="devsite-terminal" کا اطلاق کریں۔

adb devices

کوڈ:

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

ٹرمینل کوڈ کی ایک لائن کے آغاز میں $ شامل کرنے کے لیے، اس لائن پر مشتمل <code> عنصر پر class="devsite-terminal" کا اطلاق کریں۔ متعدد لائنوں میں $ والے معاملات کے لیے یہ حربہ استعمال کریں۔

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

کوڈ:

<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

حسب ضرورت سابقہ ​​استعمال کرنے کے لیے، انتساب data-terminal-prefix <pre> یا <code> عنصر میں شامل کریں جہاں کلاس لاگو کی گئی تھی۔

Install-Package Google.Apis.Calendar.v3

کوڈ:

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

"devsite-terminal" کلاس کا استعمال کرتے ہوئے شامل کیے گئے سابقہ ​​کی تمام مثالوں کو صارف کے کاپی کردہ کوڈ سے خارج کر دیا جائے گا۔

نمایاں کرنا

ایک <pre> بلاک کے اندر مواد کی طرف توجہ دلانے کے لیے <strong> استعمال کریں۔ ایسا کرنے سے ارد گرد کا مواد ہلکا ہو جائے گا تاکہ <strong> بلاک کے ذریعے نمایاں کردہ حصے پر زور دیا جا سکے۔ مثال کے طور پر:

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

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

کوڈ:

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

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

بدلنے کے قابل متغیرات

<pre> کے اندر قابل تبدیلی متن کے لیے انڈر سکور کے ساتھ <var> اور بڑے حروف کا استعمال کریں۔ مثال کے طور پر:

dev_appserver.py YOUR_APP_DIR.

کوڈ:

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

مارک ڈاؤن میں، <var> ٹیگز کو کوٹیشن مارکس میں بند کریں اور ٹیگز سے بچنے کے لیے جنجا ایکسپریشن بریکٹ استعمال کریں، اس طرح: VAR_NAME ۔

مثال کے طور پر:

Hello, my name is YOUR_NAME.

کوڈ:

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

مارک ڈاؤن

آپ مارک ڈاون کا استعمال کرتے ہوئے کوڈ بلاکس کی بھی وضاحت کر سکتے ہیں یا تو 4-اسپیس کوڈ کو انڈینٹ کرتے ہوئے یا اسے 3 بیک ٹِکس (```) کے ساتھ باڑ لگاتے ہیں۔

مثال کے طور پر:

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

دونوں بن جاتے ہیں

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

اگر آپ باڑ والے کوڈ بلاکس (اور انڈینٹڈ کوڈ بلاکس نہیں) استعمال کر رہے ہیں، تو آپ اسے سمجھنے کے لیے prettyprint کے لیے زبان بھی بتا سکتے ہیں:

print("hello world")

بن جاتا ہے

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

آپ کو تسلیم شدہ زبانوں کی فہرست Prettify دستاویزات میں مل سکتی ہے۔

مارک ڈاون کے ذریعے بنائے گئے تمام کوڈ بلاکس پر خوبصورت پرنٹ کلاس لاگو ہوگی، جب تک کہ واضح طور پر زبان کو کسی پر سیٹ نہ کیا جائے۔ آپ حسب ضرورت اوصاف کا استعمال کر کے کوڈ بلاک میں اضافی کلاسیں شامل کر سکتے ہیں:

The program completed successfully.

بن جاتا ہے

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