تغییر نحوه استفاده از یک دستور

Question

با عرض سلام. در کد زیر یک دستور با چند آرگومان تعریف شده است.

\documentclass{article}
\usepackage[margin=1in]{geometry}
\usepackage{tcolorbox}
\usepackage{xepersian}
\settextfont{XB Niloofar}
\setdigitfont{XB Niloofar}

\begin{document}
\pagestyle{empty}

\newcommand{\makeinfo}[6]{ \begin{tcolorbox}[width=\textwidth,colback=red!5!white]
        \begin{tabular}{p{5cm}r} 
            نام: #1 &  شماره دانش آموزی: #4 \\
            نام خانوادگی: #2 & آموزشگاه: #5\\
            نام پدر: #3 & شهر: #6\\
        \end{tabular}
    \end{tcolorbox}}

\makeinfo
{جواد}
{علوی}
{حمید}
{123456}
{خوارزمی}
{قم}

\end{document}

دستور \makeinfo با مقادیر داده شده به آرگومان های آن خروجی زیر را تولید می کند.

ما می خواهیم نحوه استفاده از این دستور را تغییر دهیم به طوری که هریک از آرگومانها کلید واژه خاص خود را داشته باشند و مثلا به صورت زیر از آن استفاده کنیم:

\makeform{
name=جواد ,
surname=علوی ,
father=حمید ,
studentid=123456 ,
school= خوارزمی,
city= قم}

البته با شرطی که:
1- ترتیب نوشتن این آرگومانها به صورت های مختلف تاثیری در نتیجه نداشته باشد.
2- در صورت نبود یکی از آنها در خروجی عنوان آرگومان را بنویسد اما جای مقدار آن را خالی بگذارد.
این کار چگونه ممکن است؟

Answer 1

بسته‌های زیادی واسه این کار است که معروف‌ترین‌هاش عبارتند از xkeyval, kvoptions, kvsetkeys, pgfkeys
از اونجایی که pgfkeys بخشی از بسته pgf است البته مستقل هست و به تنهایی و بدون فراخوانی کل بسته pgf هم کار میکنه و چون من خودم از بسته pgf زیاد استفاده می‌کنم بنابراین بسته pgfkeys رو به بقیه بسته‌ها ترجیح می‌دهم.
کد شما طبق شروط شما به شکل زیر است

\documentclass{article}
\usepackage[margin=1in]{geometry}
\usepackage{tcolorbox}
\usepackage{pgfkeys}
\usepackage{xepersian}
\settextfont{Yas}
\setdigitfont{Yas}

\begin{document}
\pagestyle{empty}

\pgfkeys{
    /stinfo/.cd,
    name/.store in=\name,
    surname/.store in=\surname,
    father/.store in=\father,
    studentid/.store in=\studentid,
    school/.store in=\school,
    city/.store in=\city,
    name,
    surname,
    father,
    studentid,
    school,
    city,
}

\tcbset{colframe=red!50!black,colback=white}
\newcommand{\makeinfo}[1]{
    \pgfkeys{/stinfo/.cd,#1}
     \begin{tcolorbox}[width=\textwidth,colback=red!5!white]
        \begin{tabular}{p{5cm}r} 
            نام: \name &  شماره دانش آموزی: \studentid \\
            نام خانوادگی: \surname & آموزشگاه: \school\\
            نام پدر: \father & شهر: \city\\
        \end{tabular}
    \end{tcolorbox}}

\makeinfo{
    name=جواد,
    surname=علوی,
    father=حمید,
    school=خوارزمی,
    city=قم,
    studentid=123456,
}
\end{document}

و خروجی آن به شکل زیر است.

امکانات این بسته بسیار زیاد است. جهت راهنمایی راهنمای بسته pgf از صفحه 875 را مطالعه بفرمایید
پیروز باشید.

ویرایش:
جهت برآوردن نیاز شما

\documentclass{article}
\usepackage[margin=1in]{geometry}
\usepackage{tcolorbox}
\usepackage{pgfkeys}
\usepackage{xepersian}
\settextfont{Yas}
\setdigitfont{Yas}

\begin{document}
\pagestyle{empty}

\pgfkeys{
    /stinfo/.cd,
    name/.store in=\name,
    surname/.store in=\surname,
    father/.store in=\father,
    studentid/.store in=\studentid,
    school/.store in=\school,
    city/.store in=\city,
}

\tcbset{colframe=red!50!black,colback=white}
\newcommand{\makeinfo}[1]{
    \pgfkeys{/stinfo/.cd,name,surname,father,studentid,school,city,#1}
     \begin{tcolorbox}[width=\textwidth,colback=red!5!white]
        \begin{tabular}{p{5cm}r} 
            نام: \name &  شماره دانش آموزی: \studentid \\
            نام خانوادگی: \surname & آموزشگاه: \school\\
            نام پدر: \father & شهر: \city\\
        \end{tabular}
    \end{tcolorbox}
    }

\makeinfo{
    name=جواد,
    surname=علوی,
    father=حمید,
    school=خوارزمی,
    city=قم,
    studentid=123456,
}
\makeinfo{
    surname=علوی,
    father=حمید,
    school=خوارزمی,
    city=قم,
}
\end{document}

و خروجی به شکل زیر است.

پیروز باشید.

Comments

درود بر شما.+1

---

بسیار عالی است. +1

---

سلام آقای باغبان پاسخ خود را چک کنید یک مشکلی که در آن دیده می شه اینه که اگر بخواهیم دستور را با اطلاعات جدید استفاده کنیم و یکی از ورودی ها ناقص باشه مقدار آن ورودی را که قبلا داشته است جایگزین می کند. مثلا دو دستور زیر در یک سند هر دو یک نتیجه را می دهند.
\makeinfo{
    name=جواد,
    surname=علوی,
    father=حمید,
    school=خوارزمی,
    city=قم,
    studentid=123456,
}
\makeinfo{
    surname=علوی,
    father=حمید,
    school=خوارزمی,
    city=قم,
    studentid=123456,
}
با وجود اینکه در دستور پایین پارامتر name غایب است اما در فرم همانند دستور بالا مقدار آن نشان داده می شود.

---

ویرایش را ملاحظه بفرمایید

---

بله. کاملا درست شد. بسیار متشکرم. سلامت و سربلند باشید.

---

تندرست باشید

Answer 2

سلام
تشکر می‌کنم از روش جناب باغبان عزیز و تبریک هم به خاطر پیش‌رفت‌های روز افزون شما

---

من از یک روش دیگر این کار را انجام می‌دهم و بدون استفاده از بسته و از دستورات تک برای این کار بهره می‌گیرم. ابتدا تعاریف زیر را به سند شما اضافه می‌کنم:

\makeatletter
\def\name#1{\gdef\@name{#1}}
\def\surname#1{\gdef\@surname{#1}}
\def\father#1{\gdef\@father{#1}}
\def\studentid#1{\gdef\@studentid{#1}}
\def\school#1{\gdef\@school{#1}}
\def\city#1{\gdef\@city{#1}}
\makeatother

این تعاریف را در قالب تعریف کلی در دستورات زیر می‌بینید. توجه کنید که این دستورات را global تعریف کرده‌ام که در گروه‌بندی‌ها هم به کار گرفته شوند. حالا شما کافی است که فیلد‌های زیر را به دلخواه پر کنید:

 \name{...}
 \surname{...}
 \studentid{...}
\father{...}
\school{...}
 \city{...}

سپس هر جای سند که خواستید آن کادر ظاهر شود کافی است فقط بنویسید:

\makeinfo

توجه کنید که تعریف ماکروی شما را تغییر داده‌ام تا به صورت داخلی تغذیه شود و نیاز به هیچ آرگومانی ندارد. در چند حالت مختلف هم آن را در زیر فراخوانی کرده‌ام.
پس دستورات شما مطابق زیر است:

---

\documentclass{article}
\usepackage[margin=1in]{geometry}
\usepackage{tcolorbox}
\usepackage[logo=on]{xepersian}
\settextfont{XB Niloofar}
\setdigitfont{XB Niloofar}
\makeatletter
\def\name#1{\gdef\@name{#1}}
\def\surname#1{\gdef\@surname{#1}}
\def\father#1{\gdef\@father{#1}}
\def\studentid#1{\gdef\@studentid{#1}}
\def\school#1{\gdef\@school{#1}}
\def\city#1{\gdef\@city{#1}}
\pagestyle{empty}  
\newcommand{\makeinfo}{ 
\begin{tcolorbox}[width=\textwidth,colback=red!5!white]
\begin{tabular}{p{5cm}r} 
نام:
\@name  
& 
شماره‌ی دانش آموزی: 
\@studentid
\\
نام خانوادگی:
\@surname
& آموزشگاه: 
\@school 
\\
نام پدر: 
\@father 
&
شهر: 
\@city 
\\
\end{tabular}
\end{tcolorbox}}
\makeatother
\begin{document}
\null\vfill
\name{جواد}
\surname{}
\studentid{}
\father{}
\school{}
\city{}
\makeinfo
\name{جواد}
\surname{علوی}
\studentid{}
\father{}
\school{}
\city{}
\makeinfo
\name{جواد}
\surname{علوی}
\studentid{123456}
\father{}
\school{}
\city{}
\makeinfo
\name{جواد}
\surname{علوی}
\studentid{123456}
\father{حمید}
\school{}
\city{}
\makeinfo
\name{جواد}
\surname{علوی}
\studentid{123456}
\father{حمید}
\school{خوارزمی}
\city{}
\makeinfo
\name{جواد}
\surname{علوی}
\studentid{123456}
\father{حمید}
\school{خوارزمی}
\city{قم}
\makeinfo
\end{document}

---

و این هم خروجی شما با نسخه‌ی اولیه‌ی تکلایو 2018:

---

درمورد پرسش شما در خصوص ایجاد پیام اخطار این پرسش را ببینید.

---

موفق باشید.

Comments

واقعا جالبه. متشکرم +1

---

با سلام مجدد. در این پاسخ همواره باید همه پارامترها را وارد کنیم اگرچه با مقدار خالی.  در صورت فراموشی این کار اشتباه رخ می دهد و مقادیر فرم قبلی در آن جایگزین می شود. در حالی که ما می خواهیم در صورت فراموشی آن پارامتر با مقدار خالی چاپ شود. اگرچه با دقت در این مساله می توان از بروز مشکل جلوگیری کرد اما آیا می توان دستورات را به نحوی تعریف کرد که خودبخود شرط دوم را نیز داشته باشند؟

---

@شاپور
درس پس میدیم استاد

---

M J Rezaeiani@  
پاسخ به سوال شما را در آدرس http://qa.parsilatex.com/29909/ داده ام.

---

@باغبان
شما بسیار لطف دارید اما ما هنوز شاگردیم و در حال یادگیری.