GitHub पेजों पर एक pkgdown

Gerald Girard

शनिवार, 28 दिसंबर 2024 को 10:12:25 am

शाइनीलाइव के साथ गैर-कोडर्स के लिए इंटरैक्टिविटी बढ़ाना

GitHub पेज पर डेटासेट और सहायक फ़ंक्शन होस्ट करना संसाधनों को सुलभ बनाने का एक शानदार तरीका है। आर के साथ काम करने वाले डेवलपर्स के लिए, अन्तरक्रियाशीलता का एकीकरण उपयोगकर्ता जुड़ाव को और बढ़ा सकता है, खासकर आपके डेटा की खोज करने वाले गैर-कोडर्स के लिए। शाइनीलाइव ऐसी अन्तरक्रियाशीलता को सीधे pkgdown वेबसाइट में एम्बेड करने के लिए एक व्यावहारिक समाधान प्रदान करता है।

शाइनी ऐप्स को आर पैकेज या गिटहब पेज में शामिल करने पर संसाधनों की उपलब्धता के बावजूद, शाइनीलाइव को पीकेजीडाउन वेबसाइटों के साथ प्रभावी ढंग से संयोजित करने पर ज्ञान का अंतर बना हुआ है। डेटासेट और सहायक कार्यों के साथ छोटे आर पैकेज बनाए रखने वाले व्यक्ति के रूप में, आपका लक्ष्य संभवतः डेटा अन्वेषण को सहज और उपयोगकर्ता के अनुकूल बनाना है। शाइनीलाइव इस अंतर को पाट सकता है।

आपकी pkgdown वेबसाइट के "आर्टिकल्स" अनुभाग में एक शाइनी ऐप को शामिल करने से आर पैकेज दस्तावेज़ीकरण को ओवरलोड किए बिना इंटरैक्टिव सुविधाएँ प्रदान करने का एक सुव्यवस्थित तरीका मिलता है। यह विधि सुनिश्चित करती है कि कोडिंग से अपरिचित उपयोगकर्ता भी आसानी से डेटा को सब्मिट और विज़ुअलाइज़ कर सकते हैं। यह डेवलपर्स और उपयोगकर्ताओं दोनों के लिए फायदे का सौदा है! 🚀

उदाहरण के लिए, एक स्वास्थ्य डेटासेट की कल्पना करें जहां उपयोगकर्ता जनसांख्यिकी के आधार पर जनसंख्या डेटा फ़िल्टर कर सकते हैं। शाइनीलाइव का उपयोग करके, आप इस ऐप को GitHub पेज पर बना और तैनात कर सकते हैं, जिससे डेटा को गतिशील तरीके से एक्सेस किया जा सकेगा। यह आलेख बताता है कि आपके मौजूदा ऐप सेटअप के साथ चरण-दर-चरण इसे कैसे प्राप्त किया जाए। 🛠️

आज्ञा	उपयोग का उदाहरण
selectInput	विकल्पों के चयन के लिए ड्रॉपडाउन मेनू बनाने के लिए शाइनी यूआई में उपयोग किया जाता है। उदाहरण: चयन इनपुट ("var", "चर चुनें:", विकल्प = नाम (mtcars))। यह वैरिएबल चयन के लिए गतिशील उपयोगकर्ता इनपुट की अनुमति देता है।
sliderInput	उपयोगकर्ताओं को मानों की एक श्रृंखला का चयन करने की सुविधा देने के लिए शाइनी में एक स्लाइडर इनपुट विजेट बनाता है। उदाहरण: स्लाइडर इनपुट ("रेंज", "फ़िल्टर रेंज:", न्यूनतम = 0, अधिकतम = 100, मान = सी(25, 75))। इंटरैक्टिव फ़िल्टरिंग के लिए आवश्यक.
renderPlot	उपयोगकर्ता इनपुट के आधार पर गतिशील रूप से प्लॉट उत्पन्न करने के लिए शाइनी सर्वर लॉजिक में उपयोग किया जाता है। उदाहरण: आउटपुट$प्लॉट
filter	A function from dplyr to subset data based on conditions. Example: filter(get(input$var) >शर्तों के आधार पर dplyr से डेटा को सबसेट करने के लिए एक फ़ंक्शन। उदाहरण: फ़िल्टर(प्राप्त करें(इनपुट$var) >=इनपुट$रेंज[1])। डेटासेट पर उपयोगकर्ता-परिभाषित फ़िल्टर लागू करने के लिए उपयोगी।
aes_string	x और y अक्ष जैसे सौंदर्यशास्त्र को प्रोग्रामेटिक रूप से सेट करने के लिए ggplot2 में उपयोग किया जाता है। उदाहरण: aes_string(x = इनपुट$var). गतिशील कथानक निर्माण के लिए आदर्श।
geom_histogram	हिस्टोग्राम विज़ुअलाइज़ेशन बनाने के लिए एक ggplot2 परत। उदाहरण: जियोम_हिस्टोग्राम (डिब्बे = 10, भरें = "नीला", रंग = "सफेद")। किसी ऐप में वितरण को विज़ुअलाइज़ करने के लिए उपयोगी।
uses	पुन: प्रयोज्य क्रियाओं को निर्दिष्ट करने के लिए GitHub क्रियाओं में YAML सिंटैक्स। उदाहरण: उपयोग: Actions/checkout@v3. पूर्वनिर्धारित वर्कफ़्लो के साथ निर्बाध एकीकरण सुनिश्चित करता है।
shinylive.js	ब्राउज़र में शाइनी ऐप्स चलाने के लिए एक जावास्क्रिप्ट लाइब्रेरी। उदाहरण: . स्थिर HTML पृष्ठों में शाइनी ऐप्स को एम्बेड करने में सक्षम बनाता है।
Shinylive.App	एक निर्दिष्ट HTML कंटेनर में शाइनीलाइव ऐप को प्रारंभ और चलाता है। उदाहरण: कॉन्स्ट ऐप = नया शाइनीलाइव.ऐप('#शाइनी-ऐप'); ब्राउज़र-आधारित ऐप कार्यक्षमता प्रदान करता है।
sliderInput	संख्यात्मक श्रेणी चयन के लिए एक स्लाइडर इनपुट बनाता है। उदाहरण: स्लाइडर इनपुट ("रेंज", "फ़िल्टर रेंज:", न्यूनतम = 0, अधिकतम = 100, मान = सी(25, 75))। उपयोगकर्ताओं के लिए डायनामिक रेंज फ़िल्टरिंग जोड़ता है।

शाइनीलाइव के साथ इंटरएक्टिव डेटा एक्सप्लोरेशन टूल बनाना

आर और शाइनी का उपयोग करके निर्मित पहली स्क्रिप्ट, एक गतिशील इंटरफ़ेस बनाने पर केंद्रित है जो उपयोगकर्ताओं को इंटरैक्टिव रूप से डेटासेट का पता लगाने की अनुमति देती है। इनपुट चुनें उपयोगकर्ताओं को ड्रॉपडाउन मेनू से गतिशील रूप से वेरिएबल चुनने और ऐप को उनकी आवश्यकताओं के अनुरूप बनाने में सक्षम बनाने के लिए कमांड आवश्यक है। के साथ जोड़ा गया स्लाइडरइनपुट, उपयोगकर्ता डेटा को फ़िल्टर करने के लिए मानों की एक विशिष्ट श्रेणी का चयन करके अपने अन्वेषण को और परिष्कृत कर सकते हैं। उदाहरण के लिए, जैसे डेटासेट में mtcars, उपयोगकर्ता एक चर के रूप में "एमपीजी" का चयन कर सकते हैं और 20 और 30 के बीच माइलेज वाली कारों को अलग करने के लिए स्लाइडर का उपयोग कर सकते हैं। यह संयोजन एक उपयोगकर्ता के अनुकूल और सहज इंटरफ़ेस सुनिश्चित करता है। 🚀

सर्वर-साइड लॉजिक उपयोगकर्ता इनपुट के आधार पर प्रतिक्रियाशील आउटपुट उत्पन्न करके यूआई को पूरक करता है। यहाँ, रेंडरप्लॉट फ़ंक्शन महत्वपूर्ण है - यह फ़िल्टर किए गए डेटासेट को संसाधित करता है और तुरंत गतिशील विज़ुअलाइज़ेशन उत्पन्न करता है। Dplyr का एकीकरण फ़िल्टर फ़ंक्शन डेटासेट की निर्बाध सब्सेटिंग की अनुमति देता है, जबकि ggplot2 जियोम_हिस्टोग्राम दृश्यात्मक रूप से आकर्षक और सूचनाप्रद कथानक सुनिश्चित करता है। एक स्वास्थ्य डेटासेट की कल्पना करें जहां उपयोगकर्ता आयु सीमा को फ़िल्टर कर सकता है और तुरंत स्वास्थ्य मेट्रिक्स का वितरण देख सकता है - यह स्क्रिप्ट डेवलपर्स के लिए न्यूनतम प्रयास के साथ ऐसी अंतःक्रियाशीलता को संभव बनाती है।

दूसरी स्क्रिप्ट GitHub क्रियाओं का उपयोग करके तैनाती को स्वचालित करने पर केंद्रित है। यह pkgdown वेबसाइटों को कुशलतापूर्वक बनाए रखने और अद्यतन करने के लिए विशेष रूप से महत्वपूर्ण है। ए का उपयोग करके परिनियोजन-app.yaml फ़ाइल, आप अपडेट भेजने और शाइनीलाइव ऐप को तैनात करने की प्रक्रिया को स्वचालित कर सकते हैं। प्रमुख आदेश जैसे क्रियाएँ/चेकआउट@v3 सुनिश्चित करें कि रिपॉजिटरी से नवीनतम कोड का उपयोग किया जाता है, जबकि शाइनीलिव-विशिष्ट सेटअप वर्कफ़्लो में मूल रूप से एकीकृत होता है। उदाहरण के लिए, अपने ऐप को नए फ़िल्टर या सुविधाओं के साथ अपडेट करने की कल्पना करें - यह स्वचालन सुनिश्चित करता है कि परिवर्तन तुरंत ऑनलाइन दिखाई दें, समय की बचत होगी और मैन्युअल त्रुटियाँ कम होंगी। ⚙️

तीसरे समाधान में शाइनी ऐप को एक स्थिर HTML फ़ाइल में लपेटना शामिल है। का उपयोग करके shinelive.js, सक्रिय आर सर्वर की आवश्यकता को दरकिनार करते हुए, डेवलपर्स ऐप को सीधे अपनी pkgdown वेबसाइट में एम्बेड कर सकते हैं। यह विधि ऐप को बिना R इंस्टॉल किए उपयोगकर्ताओं के लिए सुलभ बनाती है, जिससे पहुंच में वृद्धि होती है। उदाहरण के लिए, एक शिक्षक जनसंख्या डेटा पर एक इंटरैक्टिव ऐप छात्रों के साथ साझा कर सकता है, जो सीधे अपने ब्राउज़र से इसका पता लगा सकते हैं। यह समाधान गैर-कोडर्स के लिए विशेष रूप से मूल्यवान है, क्योंकि यह जटिल डेटासेट को एक आकर्षक और शैक्षिक अनुभव में बदल देता है। 🌐

शाइनीलाइव का उपयोग करके एक पीकेजीडाउन वेबसाइट में एक शाइनी ऐप एम्बेड करना

समाधान 1: फ्रंटएंड और बैकएंड एकीकरण के लिए शाइनीलाइव के साथ आर

# app.R
# Load necessary libraries
library(shiny)
library(dplyr)
library(ggplot2)

# UI definition
ui <- fluidPage(
  titlePanel("Interactive Data Viewer"),
  sidebarLayout(
    sidebarPanel(
      selectInput("var", "Select Variable:",
                  choices = names(mtcars)),
      sliderInput("range", "Filter Range:",
                  min = 0, max = 100, value = c(25, 75))
    ),
    mainPanel(plotOutput("plot"))
  )
)

# Server logic
server <- function(input, output) {
  output$plot <- renderPlot({
    data <- mtcars %>%
      filter(get(input$var) >= input$range[1],
             get(input$var) <= input$range[2])
    ggplot(data, aes_string(x = input$var)) +
      geom_histogram(bins = 10, fill = "blue", color = "white")
  })
}

# Run the app
shinyApp(ui, server)

GitHub क्रियाओं का उपयोग करके शाइनीलाइव को तैनात करना

समाधान 2: GitHub क्रियाओं और शाइनीलाइव के साथ परिनियोजन को स्वचालित करना

# deploy-app.yaml
# Workflow configuration
name: Deploy ShinyLive App

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v3

    - name: Set up R
      uses: r-lib/actions/setup-r@v2

    - name: Install dependencies
      run: |
        Rscript -e "install.packages(c('shiny', 'shinylive'))"

    - name: Deploy app
      uses: posit-dev/r-shinylive@actions-v1
      with:
        app-dir: ./

शाइनी ऐप के लिए एक स्टेटिक HTML रैपर जोड़ना

समाधान 3: pkgdown एकीकरण के लिए शाइनी ऐप को स्टेटिक HTML में लपेटना

< !-- index.html -->
<!DOCTYPE html>
<html>
<head>
  <title>Interactive Shiny App</title>
  <script src="shinylive.js"></script>
</head>
<body>
  <div id="shiny-app"></div>
  <script>
    const app = new Shinylive.App("#shiny-app");
    app.run();
  </script>
</body>
</html>

शाइनीलाइव के साथ pkgdown वेबसाइटों के लिए पहुंच और प्रदर्शन बढ़ाना

उपयोग करने का एक शक्तिशाली लाभ शाइनीलाइव सक्रिय आर सर्वर पर भरोसा किए बिना स्टैंडअलोन इंटरएक्टिविटी को सक्षम करने की इसकी क्षमता है। यह इसे GitHub Pages जैसे स्थिर प्लेटफ़ॉर्म पर ऐप्स होस्ट करने के लिए एकदम सही बनाता है। पारंपरिक शाइनी ऐप्स के विपरीत, जिन्हें निरंतर सर्वर समर्थन की आवश्यकता होती है, शाइनीलाइव आपके एप्लिकेशन को एक स्व-निहित जावास्क्रिप्ट बंडल में परिवर्तित करता है। इस बंडल को सीधे आपकी pkgdown वेबसाइट में एम्बेड किया जा सकता है, जिससे उपयोगकर्ता किसी भी ब्राउज़र से आपके डेटासेट को निर्बाध रूप से एक्सप्लोर कर सकते हैं। उदाहरण के लिए, यदि आपके आर पैकेज में वायु गुणवत्ता मेट्रिक्स का डेटासेट शामिल है, तो उपयोगकर्ता किसी भी अतिरिक्त सॉफ़्टवेयर को स्थापित करने की आवश्यकता के बिना डेटा को गतिशील रूप से फ़िल्टर और विज़ुअलाइज़ कर सकते हैं। 🌍

एक अन्य लाभ इसकी अनुकूलनशीलता में निहित है गैर कोडर. ड्रॉपडाउन और स्लाइडर्स जैसी सुविधाओं को शामिल करके, आप एक ऐसा वातावरण बनाते हैं जहां कोई भी आपके डेटा के साथ इंटरैक्ट कर सकता है। उदाहरण के लिए, एक स्वास्थ्य पेशेवर कोड की एक भी पंक्ति लिखने की आवश्यकता के बिना आयु समूहों या क्षेत्रों का चयन करके जनसंख्या डेटा की जांच कर सकता है। शाइनीलाइव और गिटहब पेजों का संयोजन यह सुनिश्चित करता है कि ये इंटरैक्टिव सुविधाएं आसानी से पहुंच योग्य और सहज हों, जिससे आपका प्रोजेक्ट व्यापक दर्शकों के लिए अत्यधिक प्रभावशाली हो जाता है। 🧩

इसके अलावा, शाइनीलाइव ऐप चलाने के लिए आवश्यक संसाधनों को अनुकूलित करके आपकी pkgdown वेबसाइट के प्रदर्शन को बढ़ाता है। चूँकि संपूर्ण तर्क जावास्क्रिप्ट में संकलित है, ऐप्स तेजी से लोड होते हैं और सहज अन्तरक्रियाशीलता प्रदान करते हैं। यह विशेष रूप से बड़े डेटासेट प्रदर्शित करने के लिए उपयोगी है, जहां प्लॉट प्रस्तुत करने या फ़िल्टर लागू करने से अन्यथा देरी हो सकती है। परिणाम एक पेशेवर-ग्रेड उपयोगकर्ता अनुभव है जो आधुनिक वेब मानकों और पहुंच संबंधी अपेक्षाओं के अनुरूप है। 🚀

pkgdown वेबसाइटों पर शाइनीलाइव का उपयोग करने के बारे में अक्सर पूछे जाने वाले प्रश्न

मैं pkgdown वेबसाइट में एक शाइनी ऐप कैसे एम्बेड करूँ?
आप उपयोग कर सकते हैं ShinyLive अपने शाइनी ऐप को जावास्क्रिप्ट बंडल में बदलने और इसे इसमें एम्बेड करने के लिए Articles आपकी pkgdown वेबसाइट का अनुभाग।
क्या शाइनीलाइव ऐप्स के लिए लाइव आर सर्वर का होना आवश्यक है?
नहीं, शाइनीलाइव ऐप्स स्टैंडअलोन हैं और सक्रिय आर सर्वर की आवश्यकता के बिना सीधे ब्राउज़र में चल सकते हैं।
जब मैं GitHub में परिवर्तन करता हूं तो क्या मैं ऐप को स्वचालित रूप से अपडेट कर सकता हूं?
हाँ, आप उपयोग कर सकते हैं GitHub Actions तैनाती को स्वचालित करने के लिए. एक वर्कफ़्लो जैसा deploy-app.yaml यह आपके लिए संभाल सकता है.
मैं किस प्रकार के उपयोगकर्ता इंटरैक्शन शामिल कर सकता हूं?
आप जैसी सुविधाएं जोड़ सकते हैं selectInput ड्रॉपडाउन के लिए और sliderInput आपके ऐप को अत्यधिक इंटरैक्टिव बनाने के लिए संख्यात्मक श्रेणियों के लिए।
क्या शाइनीलाइव गैर-कोडर्स के लिए उपयुक्त है?
बिल्कुल! शाइनीलाइव गैर-कोडर्स को इंटरैक्टिव विजेट्स के माध्यम से डेटा का पता लगाने की अनुमति देता है, जिससे यह एक्सेसिबिलिटी के लिए एक बेहतरीन टूल बन जाता है।

इंटरैक्टिव डेटा अन्वेषण को आसान बनाया गया

शाइनीलाइव pkgdown वेबसाइटों में अन्तरक्रियाशीलता को एकीकृत करने के लिए एक उपयोगकर्ता-अनुकूल समाधान प्रदान करता है। शाइनी ऐप्स को ब्राउज़र-तैयार जावास्क्रिप्ट बंडलों में परिवर्तित करके, यह सभी कौशल स्तरों के उपयोगकर्ताओं के लिए आकर्षक डेटा विज़ुअलाइज़ेशन के द्वार खोलता है। उदाहरण के लिए, जनसांख्यिकी पर डेटासेट को सरल ड्रॉपडाउन मेनू और स्लाइडर्स के साथ खोजा जा सकता है। 🌟

गिटहब एक्शन के साथ शाइनीलाइव का संयोजन तैनाती प्रक्रिया को सुव्यवस्थित करता है, जिससे यह सुनिश्चित होता है कि आपकी वेबसाइट सहजता से अपडेट रहती है। चाहे आप डेवलपर हों या डेटा पेशेवर, यह दृष्टिकोण तकनीकी सामग्री और सहज उपयोगकर्ता अनुभव के बीच के अंतर को पाटता है, जिससे आपकी डेटा कहानियां वेब ब्राउज़र में जीवंत हो जाती हैं। 📊

संसाधन और संदर्भ

सामग्री और उदाहरण आधिकारिक शाइनीलाइव दस्तावेज़ीकरण और ट्यूटोरियल से प्रेरित थे। अधिक जानकारी के लिए, पर जाएँ शाइनीलाइव परिचय .
परिनियोजन वर्कफ़्लो को इससे अनुकूलित किया जाता है शाइनीलाइव गिटहब रिपॉजिटरी , जिसमें नमूना GitHub क्रियाएँ वर्कफ़्लो और एकीकरण युक्तियाँ शामिल हैं।
pkgdown एकीकरण रणनीति किसके द्वारा निर्देशित थी pkgdown दस्तावेज़ीकरण , जो आर पैकेज के लिए दस्तावेज़ीकरण वेबसाइट बनाने और प्रबंधित करने में अंतर्दृष्टि प्रदान करता है।
अतिरिक्त प्रेरणा लाइव उदाहरण की खोज से मिली एससी जनसंख्या गिटहब पेज , जो pkgdown में शाइनीलाइव के वास्तविक दुनिया के अनुप्रयोग को प्रदर्शित करता है।

GitHub पेजों पर एक pkgdown वेबसाइट में शाइनीलाइव ऐप्स को एकीकृत करना